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ar: 

tar: tape 
ar: 

tar: tape 
cpio: copy file 
ranlib: convert 
glob: filename expand 
shift: manipulate 
varargs: variable 
apply: apply a command to a set of 
echo: echo 
echo: echo 

getarg, iarge: return command line 
expr. evaluate 
traper: trap 
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biff: be notified if mail 
expr: evaluate arguments 
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at a given time. ... 

at a later time. .. 

at: execute commands at a later time. ..... 

at low priority (sh only). ••••••••.. 

atan, atan2: trigonometric functions. • • • • • 

atan2: trigonometric functions. 

atof, atoi, atoi: convert ASCII to numbers. • • . 

atoi, atoi: convert ASCII to numbers. . 

atoi: convert ASCII to numbers. 

atomically release blocked signals and wait for • 
attach serial lines as network interfaces. • • • • 

attributes. ... 

automatically. ••••••••••••••• 

auto-reboot and daemons. •••••••••• 

await completion of process. ••.•••••• 

awk: pattern scanning and processing language. 

backgammon: the game. .. 

background. • • • .. 

background processes to complete.. • 

banner on printer. • ... • 

banner: print large banner on printer. • • • • • 

base.. 

base.. 

base. ... 

base. ... 

base.. 

base. • • • • ... . . . . 

base. .. 

base. • .. 

base.... 

base for the mail aliases file.. 

base of terminal types by port. 

base subroutines, dbminit, .. 

based on ex. .. 


flock (2) 
apropos(l) 

MU 

*r(5) 

number(6) 

Mi) 

plot(3X) 

MD 

tar(5) 

Ms) 

tar(l) 

cpio(l) 

ranlib(l) 



varargs(3) 

apply(l) 

e»h(l) 

echo(l) 

getarg(3F) 

expr(l) 

traper(3F) 

Mi) 

csh(l) 

arithmetic(6) 

biff(l) 

expr(l) 

Ml) 

slattach (8C) 

ctime(3) 

ascii(7) 

od(l) 

ascii(7) 

fdate(3F) 

atof(3) 

ctime(3) 

sin(3M) 

Mi) 

a,out(5) 

assert(3X) 

setbuf(3S) 

shutdown(8) 

at(l) 

at(l) 

nice(l) 

sin(3M) 

sin(3M) 

atof(3) 

atof(3) 

atof(3) 

sigpause(2) 

slattach (8C) 

rcs(l) 

bugfiler(8) 

rc(8) 

wait(l) 

awk(l) 

backgammon(fi) 

csh(l) 

csh(l) 

banner(6) 

banner (6) 

gettytab (5) 

hosts(5) 

networks(5) 

phones(5) 

printcap(5) 

protocols(5) 

services(5) 

termcap(5) 

vgrindefs(5) 

newaiiases(l) 

ttytype(5) 

dbm(3X) 

vi(l) 
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Permuted Index 


bcopy, 
operations, 
eb: C program 
jO, jl, jn, yO, yl, yn: 

changing/ random, srandom, initstate, aetstate: 

addbib: create or extend 
roffbib: run off 
sortbib: sort 

index for a bibliography, find references in a 
indxbib, lookbib: build inverted index for a 

from, 
comsat: 
install: install 
whereis: locate source, 
find the printable strings in a object, or other 
uuencode,uudecode: encode/decode a 
fread, fwrite: buffered 
bind: 


bcopy, bcmp, bzero, ffs: 

functions. 

bit: and, or, xor, not, rshift, lshift 

sync: update the super 
update: periodically update the super 
sigblock: 

sigpause: atomically release 
sum: sum and count 
boggle: play the game of 

ching: the 
binstl: program to install 
reboot: UNIX 
mille: play Mille 
switch: multi-way command 
login,/ sh, for, case, if, while, * , • , 


fg: 

fread, fwrite: 
stdio: standard 
setbuf, set buffer, setlinebuf: assign 
generate a dump of the operating system’s profile 
jovejecoYer - recover JOVE 
send bug: mail a system 
bugfiler: file 
automatically. 

references in a bibliography, indxbib, lookbib: 

sees tores: 
sccstorcs: 
mknod: 

ntohs: convert values between host and network 
bcopy, bcmp, bzero, ffs: bit and 
swab: swap 
bcopy, bcmp, 
cc: 
prec: 
cb: 

indent: indent and format 
lint: a 

xstr: extract strings from 
mkstr: create an error message file by massaging 

by pot, 

dc: desk 
cal: print 


basename: strip filename affixes. 

battles tar: a tropical adventure game.. 

be: arbitrary-precision arithmetic language. 

bed: convert to antique media . .. 

bcmp, bzero, ffs: bit and byte string operations. » . • . 

bcopy, bcmp, bzero, ffs: bit and byte string . 

beautifier. .... 

bessel functions. . • . .. 

bessel functions: of two kinds for integer orders. 

better random number generator; routines for • • • • • 

bg: place job in background... 

bibliographic database. ... 

bibliographic database.. 

bibliographic database.. . 

bibliography, indxbib, lookbib: build inverted . . . • • 

bibliography, find references in a bibliography. 

biff: be notified if mail arrives and who it is . 

biff server... 

binaries. .. 

binary, and or manual for program. • • • .. 

binary, file, strings: .... . . . . 

binary file for transmission via mail. 

binary input/output. . . . . .. 

bind a name to a socket... 

bind: bind a name to a socket. 

binmail: send or receive mail among users. 

binstl: program to install bootloader on disk. 

bit and byte string operations. 

bit: and, or, xor, not, rshift, lshift bitwise . 

bitwise functions. 

bload: program to load standalone programs. 

block. .... . . . . 

block.... 

block signals. .. 

blocked signals and wait for interrupt.. 

blocks in a file... 

boggle. .. • . • . 

boggle: play the game of boggle. . 

book of changes and other cookies.. 

bootloader on disk. 

bootstrapping procedures. • • • • .. 

Bournes. 

branch.... 

break, continue, cd, eyal, exec, exit, export, ...••• 

break: exit while/foreach loop. 

breaksw: exit from switch. 

bring job into foreground. •••••••••••... 

brk, sbrk: change data segment size. 

buffered binary input/output. ... 

buffered input/output package... 

buffering to a stream.. 

buffers, kgmon: ... 

buffers after a system/editor crash. • .. 

bug report to 4bsd-bugs. .. ••••••• 

bug reports in folders automatically. .. 

bugfiler: file bug reports in folders .. 

build inverted index for a bibliography, find •••••. 

build RCS file from SCCS file. 

build RCS file from SCCS file. 

build special file. ... 

byte order, htonl, htons, ntohl, ........... 

byte string operations.. 

bytes. ... . . . . 

bzero, ffs: bit and byte string operations. 

C compiler... 

C precedence chart. .. 

C program beautifier.... 

C program source... 

C program verifier.. . . . . 

C programs to implement shared strings. ••••••. 

C source. .... 

cabs: Euclidean distance.. 

cal: print calendar... 

calculator. ..*. 

calendar. .... 


basename(l) 

battlestar(fi) 

Mi) 

bed(6) 

bstring(3) 

bstring(3) 

cb(l) 

jO(3M) 

bessel(3F) 

random(3) 

c#h(l) 

.ddbib(l) 

roffbib(l) 

aortbib(l) 

lookbib(l) 

lookbib(l) 

biff(l) 

comsat(8C) 

install(l) 

whereis(l) 

strings(l) 

uuencode(lC) 

fread(3S) 

bind(2) 

bind(2) 

binmail(l) 

binstl(8) 

bstring(3) 

bit(3F) 

bit(3F) 

bload(8) 

sync(8) 

update(8) 

sigblock(2) 

sigpause(2) 

sum(l) 

boggle(6) 

boggle(6) 

ching(6) 

binstl(8) 

reboot(8) 

mille(6) 

csh(l) 

sh(l) 

csh(l) 

csh(l) 

csh(l) 

brk(2) 

fread (3S) 

intro(3S) 

setbuf(3S) 

kgmon (8) 

jove_recover(l) 

sendbug(l) 

bugfiler(8) 

bugfiler(8) 

lookbib(I) 

accstorcs(l) 

sccstorcs(8) 

mknod(8) 

byteorder(3n) 

bstring(3) 

swab(3) 

bstring(3) 

cc(l) 

prec(7) 

cb(l) 

indent(l) 

lint(l) 

xstr(l) 

mkstr(l) 

hypot(3M) 

cal(l) 

dc(l) 

eal(l) 
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Permuted Index 


calendar; reminder service. . . ... . . . . calendar(l) 

syscall: Indirect system call.... . syscall(2) 

gprof: display call graph profile data.. • ..gprof(l) 

getuid, getgid: get user or group ID of the caller. . . . . ... • . getuid(3F) 

malloc, free, realloc, ealloc, alloca: memory allocator.malloc(3) 

intro: Introduction to system calls and error numbers. . . ..intro(2) 

canfield, cfscores: the solitaire card game canfield.. • • • ..canfield(6) 

canfield. canfield, cfscores: the solitaire card game .....•• canfield(6) 

printcap: printer capability data base. . . . ... printcap(5) 

termcap: terminal capability data base. * . ..termcap(5) 

canfield, cfscores: the solitaire card game canfield...canfield(6) 

cribbage: the card game cribbage...cribbage} 6) 

cd, eval, exec, exit, export, login,/ sh, for, case, if, while, t, . , break, continue,.sh(l) 

case: selector in switch.•.csh(l) 

cat: catenate and print. ..•.cat(l) 

cat man: create the cat files for the manual. • ••••• .cstman(8) 

uncompact, ccat: compress and uncompress files, and cat them, compact, .. compact}l) 

default: catchall clause in switch.csh(l) 

cat: catenate and print. • ••••••... .. cat(l) 

cat man: create the cat files for the manual.catman(8) 

cb: C program beautifier.. cb(l) 

cc: C compiler.• •.cc(l) 

compact, uncompact, ccat: compress and uncompress files, and cat them. • • • compact} 1) 

cd: change directory. • •.. . . . csh(l) 

cd: change working directory.cd(l) 

case, if, while, *, •, break, continue, cd, eval, exec,.exit, export, login, read,/ /for, .sh(l) 

fabs, floor, ceil: absolute value, floor, ceiling functions. • floor(3M) 

fabs, floor, ceil: absolute value, floor, ceiling functions. ....floor(3M) 

canfield, cfscores: the solitaire card game canfield. canfield(6) 

chdir: change current working directory.chdir(2) 

brk, sbrk: change data segment size.... brk(2) 

chdir: change default directory...chdir(3F) 

chsh: change default login shell. ... chsh(l) 

cd: change directory.. csh(l) 

chdir: change directory. •.. ... csh(l) 

ioinit: change f77 I/O initialization. ..ioinit(3F) 

chfn: change finger entry.. chfn(l) 

chgrp: change group. ... chgrp(l) 

passwd: change login password. •••••• passwd(l) 

chmod: change mode. .chmod(l) 

chmod: change mode of a file. chmod(3F) 

chmod: change mode of file. • ... chmod(2) 

umask: change or display file creation mask.csh(l) 

chown: change owner. • ... chown(8) 

chown: change owner and group of a file.chown(2) 

res: change RCS file attributes.. rcs(l) 

chroot: change root directory. . chroot(2) 

signal: change the action for a signal. .. signa)(3F) 

rename: change the name of a file. •••••* .. rename(2) 

set: change value of shell variable. ..csh(l) 

cd: change working directory.. cd(l) 

ching: the book of changes and other cookies. ching(6) 

better random number generator; routines for changing generators, /srandom, initstate, setstate: • • . random(3) 

pipe: create an interprocess communication channel.pipe(2) 

ungetc: push character back into input stream. • • • ..ungetc(3S) 

isspace, ispunct, isprint, iscntrl, isascii: character classification macros, /isdigit, isalnum, • • • • ctype(3) 

eqnchar: special character definitions for eqn. ............. eqnchar(7) 

getc, fgetc: get a character from a logical unit.. getc(3F) 

index, rindex, lnblnk, len: tell about character objects.. index(3F) 

getc, getchar, fgetc, getw: get character or word from stream.. getc(3S) 

putc, putchar, fputc, putw: put character or word on a stream.putc(3S) 

ascii: map of ASCII character set...ascii(7) 

putc, fputc: write a character to a fortran logical unit.putc(3F) 

style: analyze surface characteristics of a document. ..style(l) 

tr: translate characters.tr(l) 

prec: C precedence chart. ... prec(7) 

snake, snscore: display chase game.. snake(6) 

chdir: change current working directory.chdir(2) 

chdir: change default directory. chdir(3F) 

chdir: change directory.csh(l) 

dcheck: file system directory consistency check...dcheck(8) 

icheck: file system storage consistency check.... icheck(8) 

fsck: file system consistency check and interactive repair.. fsck(8) 

ci: check in RCS revisions...ci(l) 

checknr: check nroff/troff files. ... checknr(l) 
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Permuted Index 


co: check out RCS revisions. • ••••••••••••• co(l) 

eqn, neqn, checkeq: typeset mathematics. ............ eqn(l) 

quotacheck: file system quota consistency checker.. .....•• . quotacheck(8) 

fastboot, fasthalt: reboot /halt the system without checking the disks. ....fastboot(8) 

check nr: check nroff/troff files. . • . . ... . check nr(l) 

chfn: change finger entry.. chfn(l) 

chgrp: change group.chgrp(l) 

ching: the book of changes and other cookies. • • • • • ching(6) 

chmod: change mode.chmod(l) 

chmod: change mode of a file.chmod(3F) 

chmod: change mode of file.. . . . . chmod(2) 

chown: change owner.chown(S) 

chown: change owner and group of a file. • •••••• chown(2) 

chroot: change root directory. • . . . ..chroot(2) 

chsh: change default login shell. ... . chsh(l) 

ci: check in RCS revisions..ci(l) 

closepl:/ plot: open pi, erase, label, line, circle, arc, move, cont, point, linemod, space,.plot(3X) 

ispunct, isprint, iscntrl, isascii: character classification macros, /isdigit, isalnum, isspace, . . . . ctype(3) 

default: catchall clause in switch...csh(l) 

deanlpd: clean line printer daemon environment.. • • • cleanlpd(8) 

cleanlpd: dean line printer daemon environment. • • . • cleanlpd(8) 

uuclean: uucp spool directory clean-up. ... uuclean(8C) 

clear: clear terminal screen.. c)ear(l) 

clri: clear i-node.. clri(S) 

dear: clear terminal screen. • • • ..clear(l) 

ferror, feof, clearerr, fileno: stream status inquiries.. ferror(3S) 

esh: a shell (command interpreter) with C-like syntax...csh(l) 

cron: clock daemon. cron(8) 

close: delete a descriptor.close(2) 

shutdown: close down the system at a given time. .shutdown(8) 

fclose, (flush: close or flush a stream.. • fclose(3S) 

opendir, read dir, telldir, seekdir, rewinddir, closedir: directory operations.. directory (3) 

opendir, readdir, telldir, seekdir, rewinddir, closedir: directory operations, directory: ...••••. directory(3X) 

syslog, openlog, closelog: control system log.. syslog(3) 

circle, arc, move, cont, point, linemod, space, closepl: graphics interface, /erase, label, line, •••••• plot(3X) 

clri: clear i-node. ...clri(8) 

emp: compare two files.cmp(l) 

co: check out RCS revisions.. co(l) 

pi: Pascal interpreter code translator.pi(l) 

col: filter reverse line feeds...col(l) 

eolert: filter nroff output for CRT previewing. . • • • • colcrt(l) 

log. dmesg: collect system diagnostic messages to form error • • • • dmesg(8) 

colrm: remove columns from a file.colrm(l) 

colrm: remove columns from a file...colrm(l) 

files, comm: select or reject lines common to two sorted • • • comm(l) 

exec: overlay shell with specified command. . ... csh(l) 

time: time command.... csh(l) 

routines for returning a stream to a remote command, remd, rresvport, ruserok: .rcmd(3X) 

rexec: return stream to a remote command...rexec(3X) 

system: issue a shell command...system(3) 

system: execute a UNIX command.... system(3F) 

test: condition command. •••• .test(l) 

time: time a command. .time(l) 

nice, nohup: run a command at low priority (sh only). .nice(l) 

switch: multi-way command branch.. csh(l) 

uux: unix to unix command execution. • . • ..uux(lC) 

rehash: recompute command hash table. ... . csh(l) 

unhash: discard command hash table.... csh(l) 

hashstat: print command hashing statistics.csh(l) 

nohup: run command immune to hangups.csh(l) 

esh: a shell (command interpreter) with C-like syntax.csh(l) 

whatis: describe what a command is. . .. . . whatis(l) 

readonly, set, shift, times, trap, umask, wait: command language, /exec, exit, export, login, read, • • • sh(l) 

getarg, iarge: return command line arguments.. . . . . getarg(3F) 

repeat: execute command repeatedly.csh(l) 

rc: command script for auto-reboot and daemons.rc(8) 

onintr: process interrupts in command scripts...csh(l) 

apply: apply a command to a set of arguments. .. . . . . appiy(l) 

goto: command transfer. ..csh(l) 

else: alternative commands.. ..csh(l) 

intro: introduction to commands...intro(l) 

introduction to system maintenance and operation commands, intro: ... intro(8) 

resintro: introduction to RCS commands.rcsintro(l) 

at: execute commands at a later time..at(l) 

apropos: locate commands by keyword lookup.. apropos(l) 
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Permuted Index 


while: repeat 
lastcomm: show last 
source: read 
comm: select or reject lines 
socket: create an endpoint for 
pipe: create an interprocess 
ipcs: report in ter-process 
talkd: remote user 


files, and cat them, 
diff: differential file and directory 
rcsdiff: 
cmp: 

diff3: 3-way differential file 
intro: introduction to 
liszt: 
cc: C 

177: Fortran 77 
pc: Pascal 
error: analyze and disperse 
yacc: yet another 
fp: Functional Programming language 
wait: wait for background processes to 
wait: await 
compress, uncompress, zcat: 
compact, uncompact, ccat: 

data. 

learn: 

hangman: 


tac: 

test: 

endif: terminate 
if: 

while: repeat commands 
gettytab: terminal 
uxrc: 
if con fig: 

tip, cu: 
dose: 

getpeername: get name of 
socketpair: create a pair of 
shutdown: shut down part of a full-duplex 
accept: accept a 
connect: initiate a 
listen: listen for 
dcheck: file system directory 
icheck: file system storage 
fsck: file system 
quotacheck: file system quota 
show w hat versions of object modules were used to 

newfs: 
mk proto: 

deroff: remove nroff, troff, tbl and eqn 
setrlimit: control maximum system resource 
vlimit: control maximum system resource 
/openpl, erase, label, line, circle, arc, move, 

Is: list 

sigstack: set and/or get signal stack 
sh, for, case, if, while, s , • , break, 

fcntl: file 
ioctl: 
init: process 
getrlimit, setrlimit: 

vlimit: 
msgctl: message 
semctl: semaphore 
shmctl: shared memory 
fcntl: file 
lpc: line printer 
syslog, openlog, closelog: 
vhangup: virtually “hangup” the current 

term: 


commands conditionally. .. 

commands executed in reverse order. . . . .. 

commands from file. ... 

common to two sorted files. 

communication. .. 

communication channel. 

communication facilities status. • . • .. 

communication server. . 

compact list of users who are on the system.. 

compact, uncompact, ccat: compress and uncompress • • 

comparator. .... 

compare RCS revisions. 

compare two files. ... . . . 

comparison.... .. 

compatibility library functions.. 

compile a Franz lisp program... 

compiler... 

compiler... 

compiler.. . . . ... . . 

compiler error messages. .. 

compiler-compiler. .. 

compiler/interpreter. ... 

complete... 

completion of process.. 

compress and expand data. .. 

compress and uncompress files, and cat them. • . . • . 
compress, uncompress, zcat: compress and expand . . . 

computer aided instruction about UNIX. .. 

Computer version of the game hangman. • .. 

comsat: biff server. .. 

concatenate and print files in reverse order. 

condition command. ... 

conditional. .... 

conditional statement... 

conditionally. .. 

configuration data base.. 

configuration file for kernel. .. 

configure network interface parameters. •••••••• 

connect: initiate a connection on a socket. 

connect to a remote system. . 

connect to proc/286 system. ... 

connected peer. 

connected sockets. ... . 

connection. •••• ... 

connection on a socket. ••.•••••••••••• 

connection on a socket. .. 

connections on a socket... 

consistency check. .. 

consistency check... 

consistency check and interactive repair.. 

consistency checker..... 

construct a file, what: . 

construct a new file system.. 

construct a prototype file system. .. 

constructs. •••••••••• . 

consumption, getrlimit,.. 

consumption. ••••••••••••••••••. 

cont, point, iinemod, space, closepl: graphics/ . 

contents of directory. . 

context.. 

continue, cd, evai, exec, exit, export, login,/ •••••• 

continue: cycle in loop.... . 

control.. . . . 

control device. ... 

control initialization. .. 

control maximum system resource consumption. • • • • 

control maximum system resource consumption. 

control operations... 

control operations. 

control operations... 

control options. . 

control program... 

control system log. ... 

control terminal. 

conventional names for terminals. 


csh(l) 

lastcomm(l) 

csh(l) 

comm(l) 

socket(2) 

pipe(2) 

ip«(l) 

talkd(8C) 

users(l) 

compact(l) 

diff(l) 

rcsdiff(l) 

cmp(l) 

diff3(l) 

intro(3C) 

liszt(l) 

ee(l) 

»77(1) 

pc(l) 

error(l) 

yacc(I) 

fp(l) 

csh(l) 

wait(l) 

compress(l) 

compact(l) 

compress(l) 

learn(l) 

hangman(6) 

comsat(8C) 

tac(l) 

test(l) 

csb(l) 

esh(l) 

csh(l) 

gettytab(5) 

uxrc(8) 

ifconfig(8C) 

connect (2) 

tip(lC) 

dosc(l) 

getpeername(2) 

80 cketpair( 2 ) 

shutdown(2) 

accept(2) 

connect(2) 

listen (2) 

dcheck(8) 

icheck(8) 

fsck (8) 

quotacheck (8) 

what(l) 

newfs(8) 

mkproto(8) 

deroff(l) 

getrlimit(2) 

vlimit(3C) 

plot(3X) 

mi) 

sigstack(2) 

sh(l) 

csh(l) 

fcntl(2) 

ioctl(2) 

init(8) 

getrlimit(2) 

vlimit(3C) 

msgctl(2) 

semctl (2) 

shmctl(2) 

fcntl(5) 

lpc(8) 

8yslog(3) 

vhangup(2) 

term(7) 
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Permuted Index 


ecvt, fevt, gevt: output 
long, short: integer object 
printr, fprintf, sprintf: formatted output 
scanf, fscanf, sscanf: formatted input 

units: 
dd: 
number: 
ranlib: 
atof, atoi, atol: 
ctime, localtime, gmtime, asetirae, timezone: 

h table: 
bed: 

htonl, htons, ntohl, ntohs: 
ching: the book of changes and other 
fpu: determine presence of the floating point 

cp: 

rep: remote file 
uucp, uulog: unix to unix 
dd: convert and 
tcopy: 

doscopyd: MPS/DOS file 
cpio: 
fork: create a 
copy: standalone 


gcore: get 
functions, sin, 
sinh, 
wc: word 
sum: sum and 


recover JOVE buffers after a system/editor 

crash: what happens when the system 

fork: 

creat: 

open: open a file for reading or writing, or 

fork: 

socketpair: 

ctags: 

socket: 

mkstr: 

pipe: 

dosdisk: program to 
addbib: 
catman: 

umask: change or display file 
umask: set file 
cribbage: the card game 


lxref: lisp 
pxref: Pascal 
eolert: filter nroff output for 
more, page: file perusal filter for 


syntax. 

convert date and time to ASCII. 

time, 

tip, 

vhangup: virtually “hangup” the 
gethostid, sethostid: get/set unique identifier of 
gethostname, sethostname: get/set name of 
hostnm: get name of 
hostid: set or print identifier of 
hostname: set or print name of 
jobs: print 
sigsetmask: set 
whoami: print effective 
chdir: change 


conversion. • 

conversion. ... . 

conversion. 

conversion.. . . . ... 

conversion program. .. 

convert and copy a file. .. 

convert Arabic numerals to English. 

convert archives to random libraries. 

convert ASCII to numbers. .. 

convert date and time to ASCII.. . . . 

convert NIC standard format host tables. 

convert to antique media. •••••••••••••• 

convert values between host and network byte order. • . 

cookies. .... 

coprocessor. ... 

copy. 

copy. 

copy. 

copy a file.. . . . 

copy a mag tape. 

copy daemon. 

copy file archives in and out... 

copy of this process.. 

copy program.. 

copy: standalone copy program. 

core: format of memory image file. 

core images of running processes. • • ... • • 

cos, tan, asin, aco6, at an, at an 2: trigonometric . 

co6h, tanh: hyperbolic functions. .. • • 

count.. 

count blocks in a file. 

cp: copy.... • 

cpio: copy file archives in and out. ... . 

crash, jove_jecover.. .. 

crash: what happens when the system crashes. 

crashes.... . . . 

creat: create a new file. .. 

create a copy of this process. .. 

create a new file. .. 

create a new file. ... 

create a new process. 

create a pair of connected sockets. •••••••••• 

create a tags file. • .... 

create an endpoint for communication. 

create an error message file by massaging C source. . . • 
create an interprocess communication channel. • • . • . 
create and display information for MPS/DOS vdisks. • • 
create or extend bibliographic database. 

create the cat files for the manual.. . 

creation mask..... 

creation mode mask. 

cribbage. 

cribbage: the card game cribbage. 

cron: clock daemon. 

cross reference program.. 

cross-reference program.. 

CRT previewing. 

ert viewing. 

crypt: encode/decode. 

crypt, setkey, encrypt: DES encryption. 

esh: a shell (command interpreter) with C-like . 

ctags: create a tags file. .. 

ctime, localtime, gmtime, asetime, timezone: .. 

ctime, ltime, gmtime: return system time. 

cu: connect to a remote system. • • .. 

current control terminal. 

current host. 

current host. .. 

current host... 

current host system.. 

current host system... 

current job list... 

current signal mask. .. 

current user id. .... 

current working directory.. . • . 


ecYt(3) 

long(3F) 

printf(3S) 

scanf(3S) 

units(l) 

dd(i) 

number(fi) 

ranlib(l) 

atof(3) 

ctime(3) 

htable(8) 

bcd(6) 

byteorder(3n) 

ching(6) 

fpu(l) 

CP(1) 

rcp(lC) 

uucp(lC) 

dd(l) 

tcopy(l) 

doscopyd (8) 

cpio(l) 

fork(3F) 

copy(8) 

copy(8) 

core(5) 

gcore(l) 

sin(3M) 

sinh(3M) 

wc(l) 

sum(l) 

cp(l) 

cpio(l) 

jove_recover(l) 

crash(8V) 

crash(8V) 

creat(2) 

fork(3F) 

creat(2) 

open(2) 

fork(2) 

socketpair(2) 

ctags(l) 

socket(2) 

mkstr(l) 

pipe(2) 

dosdisk(8) 

addbib(l) 

catman (8) 

csh(l) 

umask(2) 

cribbage(6) 

cribbage(6) 

cron (8) 

Ixref(l) 

pxref(l) 

colcrt(l) 

more(l) 

crypt(l) 

crypt(3) 

csh(l) 

ctags(l) 

ctime(3) 

time(3F) 

tip(lC) 

vhangup(2) 

gethostid (2) 

gethostname(2) 

hostnm(3F) 

hostid(l) 

hostname(l) 

csh(l) 

sigsetmask(2) 

whoami(I) 

chdir(2) 
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Permuted Index 


getcwd: get pathname of current working directory.• • • ..getcwd(3F) 

getwd: get current working directory pathname.. getwd(3) 

motion, curses: screen functions with “optimal” cursor .curses(3X) 

curses: screen functions with “optimal” cursor motion. .••••• .curses(3X) 

spline: interpolate smooth curve. • . • •.. ... spline(lG) 

continue: cycle in loop. ... csh(l) 

cron: clock daemon.... ... . cron(8) 

doscopyd: MPS/DOS file copy daemon.doscopyd(8) 

dosprint: MPS/DOS spooler daemon...dosprint(8) 

Ipd: line printer daemon. .••••• ...lpd(8) 

routed: network routing daemon. • •.••...••••• .. routed(8C) 

cleanlpd: clean line printer daemon environment.•.clean lpd(8) 

rc: command script for auto-reboot and daemons.rc(8) 

ftpd: DARPA Internet File Transfer Protocol server. • . • . . ftpd(8C) 

tel net d: DARPA TELNET protocol server. ... . . telnetd(8C) 

tftpd: DARPA Trivial File Transfer Protocol server. • • • . • tftpd(8C) 

compress, uncompress, scat: compress and expand data. ...•••• .... compress(l) 

eval: re-evaluate shell data...csh(l) 

gprof: display call graph profile data...gprof(l) 

prof: display profile data. • •.. . . ....prof(l) 

ttys: terminal initialization data. • • * •.. . . . ..ttys(5) 

gettytab: terminal configuration data base.. gettytab(5) 

hosts: host name data base. • •••••* .. . . hosts(5) 

networks: network name data base. ...••••• .networks(5) 

phones: remote host phone number data base.. phones(5) 

printcap: printer capability data base. ..printcap(5) 

protocols: protocol name data base. protocols(S) 

services: service name data base... •••••• services(5) 

termcap: terminal capability data base.. • • • . termcap(5) 

vgrindefs: vgrind’s language definition data base...vgrindefs(5) 

newaliases: rebuild the data base for the mail aliases file.. • • • newaliases(l) 

ttytype: data base of terminal types by port. ..ttytype(5) 

dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines.... dbm(3X) 

brk, sbrk: change data segment size...brk(2) 

null: data sink...null(4) 

types: primitive system data types. •••••••••••.•••••••• types(5) 

addbib: create or extend bibliographic database...addbib(l) 

roffbib: run off bibliographic database.....roffbib(l) 

sortbib: sort bibliographic database. ....sortbib(l) 

join: relational database operator...join(l) 

date: print and set the date. • ... date(l) 

gettimeofday, settimeofday: get/set date and time.... gettimeofday(2) 

time, ftime: get date and time.time(3C) 

fdate: return date and time in an ASCII string.fdate(3F) 

localtime, gmtime, asctime, timezone: convert date and time to ASCII, ctime, .ctime{3) 

touch: update date last modified of a file.. touch(l) 

idate, itime: return date or time in numerical form. .idate(3F) 

date: print and set the date. ... date(l) 

file.. .PP dstrules: Daylight savings time and time zone name rule ..... dstrules(5) 
data base subroutines, dbminit, fetch, store, delete, firstkey, nextkey: ..... dbm(3X) 

dbx: debugger. .. dbx(l) 

dc: desk calculator. ... dc(l) 

dcheck: file system directory consistency check. ..... dcheck(8) 

dd: convert and copy a file.dd(l) 

adb: debugger...adb(l) 

dbx: debugger... •••.. dbx(l) 

pdx: pascal debugger.... pdx(l) 

od: octal, decimal, hex, ascii dump.od(l) 

default: catchall clause in switch. ..csh(l) 

chdir: change default directory...chdir(3F) 

chsh: change default login shell.chsh(l) 

vgrindefs: Ygrind’s language definition data base.. • • • vgrindefs(5) 

mode.. Standalone mode: definition of this Sanyo/ICON machine operation • • • • standalone(8) 

eqnchar: special character definitions for eqn. • .. ••••••••• eqnchar(7) 

stty, gtty: set and get terminal state (defunct).stty(3C) 

dose: delete a descriptor...close(2) 

dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines.dbm(3X) 

tail: deliver the last part of a file.. ..tail(l) 

mesg: permit or deny messages.mesg(l) 

tset: terminal dependent initialization. • ..tset(l) 

constructs, deroff: remove nroff, troff, tbl and eqn.deroff(l) 

crypt, setkey, encrypt: DES encryption...crypt(3) 

whatis: describe what a command is.whatis(l) 

mailaddr: mail addressing description.. mailaddr(7) 

getdiskbyname: get disk description by its name.getdisk(3X) 
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remote: remote host description file...remote(5) 

dose: delete a descriptor.. elose(2) 

dup, dup2: duplicate a descriptor. ••••• dup(2) 

getfstype, setfsent, endfsent: get file system descriptor file entry, /getfsspec, getfsfile, .getfsent(3X) 

getdt&blesize: get descriptor table size. ..getdtablesize(2) 

dc: desk calculator. ••••••• .dc(l) 

dosprinters: destinations for spooled output from SLPT printers. • • dosprinters(5) 

access: determine accessability of a file. ... access(3F) 

access: determine accessibility of file.access(2) 

file: determine file type...file(l) 

coprocessor, fpu: determine presence of the floating point .fpu(l) 

fold: fold long lines for finite width output device.fold(l) 

ioctl: control device. ..ioctl(2) 

swapon: specify additional device for paging and swapping.. swapon(8) 

df: disk free.df(l) 

flmin, flmax, ffrac, dflmin, dflmax, d ffrac, Inmsx: return extreme values.flmin(3Fl 

fimin, flmax, ffrac, dflmin, dflmax, dffrac, inmax: return extreme values.flmin(3F) 

values, flmin, flmax, ffrac, dflmin, dflmax, dfffac, inmax: return extreme .flmin (3F) 

dmesg: collect system diagnostic messages to form error log.dmesg(8) 

print wordy sentences; thesaurus for diction. diction,explain: ••••••••••••••• diction(l) 

diction- print wordy sentences; thesaurus for diction, explain, .explain(l) 

diction, explain, diction- print wordy sentences; thesaurus for .explain(l) 

for diction, diction,explain: print wordy sentences; thesaurus • • • • diction(l) 

diff: differential file and directory comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

diff: differential file and directory comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

dir: format of directories. .. dir(5) 

dir: format of directories.dir(5) 

rm, rmdir: remove (unlink) files or directories.. rm(l) 

rmdir, rm: remove (unlink) directories or files. . . . rmdir(l) 

cd: change working directory. . . . cd(l) 

chdir: change current working directory.. chdir(2) 

chdir: change default directory.chdir(3F) 

chroot: change root directory. chroot(2) 

cd: change directory.. csh(l) 

chdir: change directory...csh(l) 

getewd: get pathname of current working directory... getcwd(3F) 

Is: list contents of directory.. ls(l) 

mkdir: make a directory. ..... mkdir(l) 

scan dir: scan a directory.scandir(3) 

swapon: specify a swap directory..swapon(2) 

uuclean: uucp spool directory clean-up.uuclean(8C) 

diff: differential file and directory comparator. ... diff(l) 

dcheck: file system directory consistency check. ..dcheck(8) 

unlink: remove directory entry. ••••• unlink(2) 

unlink: remove a directory entry. .. unlink(3F) 

mkdir: make a directory file.... mkdir(2) 

rmdir: remove a directory file.rmdir(2) 

mklost+found: make a lost+found directory for fsck. ••••••••••• mklost+found(8) 

pwd: working directory name...pwd(l) 

rewinddir, closedir: directory operations, directory: opendir, readdir, telldir, seekdir,.directory(3X) 

readdir, telldir, seekdir, rewinddir, closedir: directory operations, opendir, ..directory(3) 

readdir, telldir, seekdir, rewinddir, closedir: directory operations, directory: opendir, . ..directory(3X) 

getwd: get current working directory pathname.... getwd(3) 

popd: pop shell directory stack.. csh(l) 

pushd: push shell directory stack.... csh(l) 

die: an mc68020 disassembler...dis(l) 

dis: an mc68020 disassembler. • ... • dis(l) 

quota: display disc usage and limits.quota(l) 

unhash: discard command hash table. ..csh(l) 

unset: discard shell variables. • ..csh(l) 

binstl: program to install bootloader on disk. ••••••• binstl(8) 

synchronize a file’s in-core state with that on disk, fsync: ..fsync(2) 

getdiskbyname: get disk description by its name. • • • getdisk(3X) 

dkfmt: standalone disk formatter.. dkfmt(8) 

df: disk free.df(l) 

park: program to park the hard disk heads.park(8) 

quota: manipulate disk quotas.....quota(2) 

du: summarize disk usage...du(l) 

dosdisks: list of MPS/DOS virtual disks.dosdisks(5) 

reboot/halt the system without checking the disks, fastboot, fasthalt: .fastboot(8) 

mount, umount: mount and dismount file system.mount(8) 

error: analyze and disperse compiler error messages. .error(l) 

rain: animated raindrops display.rain(6) 
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Permuted Index 


gprof; 
snake, 8 ns core: 
quota: 

▼i: screen oriented (visual) 
umask: change or 
whodos: 

doedisk: program to create and 
prof: 
sysline: 

worms: animate worms on a 
jove: an interactive 
bypot, cabs: Euclidean 
rdist: remote file 


error log. 

style: analyze surface characteristics of a 
refer: find and insert literature references in 
w: who is on and what they are 
rogue: Exploring The Dungeons of 

whodos: display information about 

for MPS/DOS vdisks. 


SLPT printers, 
shutdown: shut 
shutdown: close 
rand, 
graph: 
arithmetic: provide 
rule file.. .PP 
etime, 

dump: incremental file system 
od: octal, decimal, hex, ascii 
rdump: file system 
rrestore: restore a file system 

dumpfs: 

dump, dumpdates: incremental 

kgmon: generate a 
dump, 

rogue: Exploring The 

dup, 
dup, dup2: 
echo: 
echo: 


ping: send ICMP 


end, etext, 
ex, 
vipw: 
edquota: 
ed: text 
ex, edit: text 

jove: an interactive display-oriented text 

Id: link 
sed: stream 

TEACHJOVE - learn how to use the JOVE 
vi: screen oriented (visual) display 
a.out: assembler and link 

whoami: print 
setregid: set real and 
setreuid: set real and 
vfork: spawn new process in a virtual memory 


display call graph profile data. . . .. 

display chase game..*. 

display disc usage and limits. • • •. 

display editor based on ex.. 

display file creation mask. ... 

display information about dose users. • .. 

display information for MPS/DOS vdisks. 

display profile data . 

display system status on status line of a terminal. • • • 

display terminal. .... 

display-oriented text editor. • . • • •.. 

distance.... 

distribution program. *.. . . . 

dkfmt: standalone disk formatter. . 

dmem, kmem: main memory. ... . . . . 

dmesg: collect system diagnostic messages to form • . . 

doctor: interact with a psychoanalyst. 

document... 

documents. • •.... . 

doing. • •*••••••. . 

Doom. ..•••••••••. .. . . . 

dose: connect to proc/286 system... 

dose users.. . .. 

doscopyd: MPS/DOS file copy daemon.. 

dosdisk: program to create and display information • . • 

dosdisks: list of MPS/DOS virtual disks. .. 

dosprint: MPS/DOS spooler daemon. .. 

dosprinters: destinations for spooled output from . • • • 
down part of a full-duplex connection. ........ 

down the system at a given time. 

drand, irand: return random values. • .. 

draw a graph. ..... 

drill in number facts. ... 

dstrules: Daylight savings time and time zone name • • . 

dtime: return elapsed execution time. 

du: summarize disk usage.... • . . 

dump.. .. 

dump. •••• 

dump across the network. 

dump across the network. ••..... . 

dump, dumpdates: incremental dump format. 

dump file system information. 

dump format. • • • . ••••••• 

dump: incremental file system dump. 

dump of the operating system’s profile buffers. 

dumpdates: incremental dump format. • .. 

dumpfs: dump file system information. 

Dungeons of Doom.... 

dup, dup2: duplicate a descriptor. .* • . • 

dup2: duplicate a descriptor.. 

duplicate a descriptor. • .. 

echo arguments. ... . . . .. 

echo arguments. • ... .. 

echo: echo arguments. • • • ... 

echo: echo arguments. ... . • 

ECHCLREQUEST packets to network hosts. 

ecvt, fevt, gevt: output conversion. •••••••••• 

ed: text editor... 

edata: last locations in program. 

edit: text editor. .. 

edit the password file. • .... 

edit user quotas... 

editor. .... 

editor. • • •... 

editor.... 

editor... 

editor. 

editor... 

editor based on ex. .. 

editor output. 

edquota: edit user quotas. 

effective current user id.. . 

effective group ID. • • . • .. 

effective user ID’s. .. 

efficient way... 


gprof(l) 

snake(6l 

quotafl) 

vi(l) 

csh(l) 

whodos(l) 

dosdisk(8) 

prof(l) 

sysline(l) 

worms(6) 

jove(l) 

hypot(3M) 

rdist(l) 

dkfmt(8) 

mem (4) 

dmesg(8) 

doctor(6) 

style(l) 

refer(l) 

w(l) 

rogue(6) 

dosc(l) 

whodos(l) 

doscopyd (8) 

dosdisk(8) 

dosdisks(S) 

dosprint(8) 

dosprinters(5) 

shutdown(2) 

shutdown(8) 

rand(3F) 

graph(lG) 

arithmetic(6) 

dstrules(5) 

etime(3F) 

du(l) 

dump(8) 

od(l) 

rdump (8C) 

rrestore(SC) 

dump(5) 

dumpfs(8) 

dump(5) 

dump(8) 

kgmon(8) 

dump(5) 

dumpfs(8) 

rogue(6) 

dup(2) 

dup(2) 

dup(2) 


csh(l) 

echo(l) 

csh(l) 

echo(l) 

ping(8) 

ecvt(3) 

ed(l) 

end(3) 

ex(l) 

vipw(8) 

edquota(8) 

*d(l) 

ex(l) 

jove(l) 

ld(l) 

sed(I) 

teachjove(l) 

Yi(l) 

a.out(5) 

edquota(8) 

whoami(l) 

setregid(2) 

setreuid(2) 

vfork (2) 
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eil: Extended Fortran Language.efl(l) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

etime, dtime: return elapsed execution time.etime(3F) 

insque, remque: insert/remove element from a queue...insque(3) 

soelim: eliminate .so’s from nroff input.soelim(l) 

else: alternative commands. ..csh(l) 

setquota: enable/disable quotas on a file system.setquota(2) 

uuencode: format of an encoded uuencode file.uuencode(5) 

crypt: encode/decode.crypt(l) 

mail, uuencode,uudecode: encode/decode a binary file for transmission yia • • • • uuencode(lC) 

crypt, setkey, encrypt: DES encryption. .crypt(3) 

crypt, setkey, encrypt: DES encryption...crypt(3) 

makekey: generate encryption key.makekey(8) 

end, etext, edata: last locations in program.end(3) 

logout: end session.... csh(l) 

end: terminate loop. • • . ... . • . . csh(l) 

/getfsspec, getfsfile, getfstype, setfsent, endfsent: get file system descriptor file entry.getfsent(3X) 

getgrent, getgrgid, getgrnam, setgrent, endgrent: get group file entry.. . . getgrent(3) 

gethostbyaddr, gethostbyname, sethostent, endhostent: get network host entry, gethoetent, . . . . gethostent(3n) 

endif: terminate conditional. .csh(l) 

getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent: get network entry.• . • . • getnetent(3n) 

socket: create an endpoint for communication. • • • •.socket(2) 

getprotobynumber, getprotobyname, setprotoent, endprotoent: get protocol entry, getprotoent, .getprotoent(3n) 

getpwent, getpwuid, getpwnam, setpwent, endpwent: get password file entry.getpwent(3) 

getservbyport, getservbyname, setservent, endservent: get service entry, getservent, .getservent(3n) 

endsw: terminate switch. .csh(l) 

number: convert Arabic numerals to English.• •.number(6) 

xsend, xget, enroll: secret mail. .xsend(l) 

nlist: get entries from name list. ...nlist(3) 

chfn: change finger entry. ... chfn(l) 

setfsent, endfsent: get file system descriptor file entry, getfsent, getfsspec, getfsfile, getfstype, .getfsent(3X) 

getgrnam, setgrent, endgrent: get group file entry, getgrent, getgrgid, ..getgrent(3) 

sethostent, endhostent: get network host entry. getho6tent, gethostbyaddr, gethostbyname, • • • gethostent(3n) 

getnetbyname, setnetent, endnetent: get network entry, getnetent, getnetbyaddr, . • getnetent(3n) 

setprotoent, endprotoent: get protocol entry, /getprotobynumber, getprotobyname, . • • . • getprotoent(3n) 

getpwnam, setpwent, endpwent: get password file entry, getpwent, getpwuid, . . getpwent(3) 

getservbyname, setservent, endservent: get service entry, getservent, getservbyport, ••••..•••.. getservent(3n) 

unlink: remove directory entry...unlink(2) 

unlink: remove a directory entry. unlink(3F) 

execl, exeev, execle, exeelp, exeevp, exec, exece, environ: execute a file.... execl(3) 

environ: user environment.... environ(7) 

cleanlpd: clean line printer daemon environment. ... cleanlpd(8) 

setenv: set variable in environment...csh(l) 

environ: user environment. ...environ(7) 

printenv: print out the environment.. printenv(l) 

window: window environment. ••••. window(l) 

getenv: value for environment name. ....getenv(3) 

unsetenv: remove environment variables. .. csh(l) 

getenv: get value of environment variables.getenv(3F) 

eqnchar: special character definitions for eqn...eqnchar(7) 

deroff: remove nroff, troff, tbl and eqn constructs.. deroff(l) 

eqn, neqn, checkeq: typeset mathematics.eqn(l) 

eqnchar: special character definitions for eqn.eqnchar(7) 

linemod, space, closepl: graphics/ plot: openpl, erase, label, line, circle, arc, move, cont, point, .plot(3X) 

messages, error: analyze and disperse compiler error ••••••. error(l) 

dmesg: collect system diagnostic messages to form error log.dmesg(8) 

mkstr: create an error message file by massaging C source. ••••••• mkstr(l) 

error: analyze and disperse compiler error messages.. • error(l) 

perror, sys_errlist, sys_nerr: system error messages.. perror(3) 

perror, gerror, ierrno: get system error messages. perror(3F) 

intro: introduction to system calls and error numbers...intro(2) 

eyacc: modified yacc allowing much improved error recovery.eyacc(l) 

spell, spellin, spellout: find spelling errors...spell(l) 

traper: trap arithmetic errors.traper(3F) 

end, etext, edata: last locations in program.. end(3) 

etime, dtime: return elapsed execution time. • etime(3F) 

hypot, cabs: Euclidean distance...hypot(3M) 

/if, while, i , • , break, continue, cd, eyal, exec, exit, export, login, read, readonly,/ ..... sh(l) 

eval: re-evaluate shell data...csh(l) 

expr: evaluate arguments as an expression.expr(l) 

history: print history event list. •••• csh(l) 

screen oriented (visual) display editor based on ex. vi: ...vi(l) 

ex, edit: text editor.ex(l) 

Ipq: spool queue examination program.lpq(l) 

execl, exeev, execle, exeelp, exeevp, exec, exece, environ: execute a file.. execl(3) 
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Permuted Index 


/while, «, . , break, continue, cd, eval, 

execl, exeev, execle, execip, execyp, exec, 
environ: execute a file, 
execute a file, exed, exeev, 
file, execl, exeev, execle, 
sticky: 

execle, execip, exeevp, exec, exece, environ: 

exeeve: 

alarm: 

system: 

repeat: 

at: 

lastcomm: show last commands 
uux: unix to unix command 
acct: 

sleep: suspend 
sleep: suspend 
sleep: suspend 

monitor, monstartup, moncontrol: prepare 

pxp: Pascal 
rexecd: remote 
etime, dtime: return elapsed 
profil: 

pix: Pascal interpreter and 
environ: execute a file, execl, 

execl, exeev, execle, execip, 
link: make & link to an 
tunefs: tune up an 
/ : , . , break, continue, cd, eval, exec, 
breaksw: 


pending output. 

break: 

power, square root, 
glob: filename 

compress, uncompress, zcat: compress and 
expand, unexpand: 

versa, 
for diction, 
diction, diction, 
aardvark: yet another 
adventure: an 
rogue: 

frexp, ldexp, modf: split into mantissa and 
exp, log, loglO, pow, sqrt: 
/ . , break, continue, cd, eval, exec, exit, 

expr: evaluate arguments as an 
reL-comp, re_exec: regular 
addbib: create or 
efl: 

strings, xstr: 
recovery. 

ioinit: change 

tclose, tread, twrite, trewin, tskipf, tstate: 

functions. 

signal: simplified software signal 
sigvec: software signal 
ipcs: report inter-process communication 

true, 

checking the disks, 
the disks, fastboot, 
abort: generate a 
trpfpe, fpeent: trap and repair floating point 
export, login,/ sh, for, case, if, while, : , 
exit, export, login,/ sh, for, case, if, while, 


exec, exit, export, login, read, readonly, set,/ • . . 
exec: overlay shell with specified command. • . . 

exece, environ: execute a file.. . . 

execl, exeev, execle, execip, exeevp, exec, exece, . . 
execle, execip, exeevp, exec, exece, environ: • • • • 
execip, exeevp, exec, exece, environ: execute a . * • 
executable files with persistent text. • •••••• 

execute a file, execl, exeev, . .. 

execute a file. • ••••••••••.•••• 

execute a subroutine after a specified time. 

execute a UNIX command.. 

execute command repeatedly. • •••*•••• 

execute commands at a later time.• • • 

executed in reverse order. • 

execution. • •.*. 

execution accounting file. ...... . 

execution for an interval. 

execution for an interval. 

execution tor interval. • •. 

execution profile. 

execution profiler.. . . . . 

execution server. • • •.. 

execution time... 

execution time profile. .. 

executor... 

exeev, execle, execip, exeevp, exec, exece, . 

exeeve: execute a file. 

exeevp, exec, exece, environ: execute a file. 

existing file. .... . 

existing file system. • .. 

exit, export, login, read, readonly, set, shift,/ • • • 

exit from switch. .. 

exit: leave shell.. .. 

.exit: terminate a process. .. 

exit: terminate a process after flushing any . • • • 

exit: terminate process with status. .. 

exit while/foreach loop. •••••••••••• 

exp, log, loglO, pow, sqrt: exponential, logarithm, • 

expand argument list. 

expand data. ... 

expand tabs to spaces, and vice versa. •••••• 

expand, unexpand: expand tabs to spaces, and vice 
explain, diction- print wordy sentences; thesaurus 
explain: print wordy sentences; thesaurus for ... 

exploration game. .. 

exploration game.. 

Exploring The Dungeons of Doom.. • 

exponent.. 

exponential, logarithm, power, square root. • . • 
export, login, read, readonly, set, shift, times,/ • • 
expr: evaluate arguments as an expression. .... 

expression. 

expression handler. •••••• 

extend bibliographic database.. 

Extended Fortran Language.. • • • 

extract strings from C programs to implement shared 
eyacc: modified yacc allowing much improved error 

177: Fortran 77 compiler. • • • .. 

f77 I/O initialization.. .. 

f77 tape I/O. topen, . 

fabs, floor, ceil: absolute value, floor, ceiling . • • 

facilities. .. 

facilities.. 

facilities status. ... 

false: provide truth values. 

false, true: provide truth values. • .. 

fastboot, fasthalt: reboot/halt the system without 
fasthalt: reboot/halt the system without checking 

fault. .. 

faults. 

. , break, continue, cd, eval, exec, exit, . 

t , • , break, continue, cd, eval, exec.. • 

fclose, fflush: close or flush a stream. 

fenti: file control... 

fcntl: file control options.. • • • • 


.h(i) 

csh(l) 

exed(3) 
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execl(3) 

execl(3) 

sticky(8) 

execl(3) 

execve(2) 

alarm(3F) 

system (3F) 

esh(l) 

«t(i) 

lastcomm(l) 

uux(lC) 

acct(5) 

8leep(l) 

sleep(3F) 

sleep(3) 

monitor(3) 

pxp(l) 

rexecd (8C) 

etime(3F) 

profil(2) 

Mi) 
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execve(2) 

execl(3) 

link(3F) 

tunefs(8) 

sh(l) 

esb(l) 

csh(l) 

e»t(2) 

exit(3) 

exit(3F) 

csh(l) 

exp(3M) 

csh(l) 

compress(l) 

expand(l) 

expand(l) 

explain(l) 

diction(l) 

aardvark (6) 

adventure(6) 

rogue(6) 

frexp (3) 

exp(3M) 

sh(I) 

expr(l) 

expr(l) 

regex(3) 

addbib(l) 

efl(l) 

xstr(l) 

eyacc(l) 

*77(1) 

ioinit(3F) 

topen(3F) 

fioor(3M) 

8ignal(3C) 

sigvec(2) 

ipcs(l) 

true(l) 

false(l) 

fastboot(8) 

fastboot(B) 

abort(3) 

trpfpe(3F) 

sh(l) 

sh(l) 

fclose(3S) 

fcntl(2) 

fentl(5) 
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eevt, fcvt, gcvt: output conversion.. ecvt(3) 

fdate: return date and time in an ASCII string.fdate(3F) 

fopen, freopen, fdopen: open a stream. • ••••••••••••.. fopen(3S) 

ferror, feof, dearerr, fileno: stream status inquiries.ferror(3S) 

inquiries, ferror, feof, clear err, fileno: stream status ••••••• ferror(3S) 

subroutines, dbminit, fetch, store, delete, first key, nextkey: data base . . . . . dbm(3X) 

head: give first few lines.head(I) 

fdose, flush: close or flush a stream.. fclose(3S) 

extreme values, flmin, fimax, ffrac, dflmin, dflmax, dffrac, inmax: return.flmin(3F) 

bcopy, bcmp, bzero, ffs: bit and byte string operations.bstring(3) 

fg: bring job into foreground.. . csh(l) 

getc, fgetc: get a character from a logical unit. .getc(3F) 

getc, getchar, fgetc, getw: get character or word from stream. • . . . • getc(3S) 

gets, fgets: get a string from a stream.gets(3S) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

locate a program file including aliases and paths (cthonly). which: .which(l) 

robots: fight off villainous robots...robots(6) 

access: determine accessibility of file...access(2) 

access: determine accessability of a file.access(3F) 

acct: execution accounting file.. acct(5) 

chmod: change mode of file.....chmod(2) 

chmod: change mode of a file.chmod(3F) 

chown: change owner and group of a file. • • • •.chown(2) 

colrm: remove columns from a file. . ... colrm(l) 

core: format of memory image file...core(5) 

creat: create a new file.... . creat(2) 

source: read commands from file. ..csb(l) 

ctags: create a tags file...ctags(l) 

dd: convert and copy a file.... dd(l) 

Daylight savings time and time zone name rule file.. .PP dstrules: . dstrules(5) 

execlp, execvp, exec, exece, environ: execute a file, execl, execv, execle,.. execl(3) 

execve: execute a file. . •••••••••••• execve(2) 

flock: apply or remove an advisory lock on an open file.. flock(2) 

fpr: print Fortran file.fpr(l) 

group: group file..... group(5) 

link: make a hard link to a file.. link(2) 

link: make a link to an existing file. ... link(3F) 

mkdir: make a directory file. ... mkdir(2) 

mknod: make a special file. ..mknod(2) 

mknod: build special file. ..mknod(8) 

rebuild the data base for the mail aiiases file, newaliases: .newaliases(l) 

open a file for reading or writing, or create a new file, open:.. open(2) 

passwd: password file...passwd(5) 

pr: print file.... pr(l) 

rcsfile: format of RCS file...rcsfi!e(5) 

remote: remote host description file...remote(5) 

rename: change the name of a file.... • • • rename(2) 

rename: rename a file.. rename(3F) 

rev: reverse lines of a file.rev(l) 

rmdir: remove a directory file...rmdir(2) 

sccstorcs: build RCS file from SCCS file. sccstorcs(l) 

sccstores: build RCS file from SCCS file. sccstorcs(8) 

sfdate: set the time/date of a file. .. ..sfdate(l) 

size: size of an object file.size(l) 

the printable strings in a object, or other binary, file, strings: find ... strings(l) 

sum: sum and count blocks in a file. ••••' .... sum(l) 

symlink: make symbolic link to a file. .symlink(2) 

tail: deliver the last part of a file. •••• ...tail(l) 

touch: update date last modified of a file...touch(l) 

uniq: report repeated lines in a file. .uniq(l) 

uuencode: format of an encoded uuencode file...uuencode(S) 

vipw: edit the password file. ... •••• vipw(8) 

versions of object modules were used to construct a file, what: show what ••••.••••• what(l) 

write, writev: write on a file...write(2) 

diff: differential file and directory comparator.diff(l) 

cpio: copy file archives in and out. cpio(l) 

res: change RCS file attributes...rcs(l) 

bugfiler: file bug reports in folders automatically.bugfiler(8) 

mkstr: create an error message file by massaging C source.mkstr(l) 

diff3: 3-way differential file comparison. .. ••••• diff3(l) 

fcntl: file control. ....•••• .. fcntl(2) 

fcntl: file control options. • ..fcntl(5) 

rep: remote file copy. ... rcp(lC) 

doscopyd: MPS/DOS file copy daemon. doscopyd(8) 

umask: change or display file creation mask.csh(l) 
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umask: set file creation mode mask. . . . ..umask(2) 

file: determine file type. . . ..file(l) 

rdist: remote file distribution program. • ••••.... .rdist(l) 

setfsent, endfsent: get file system descriptor file entry, /getfsspec, getfsfile, getfstype.getfsent(3X) 

getgrgid, getgrnam, setgrent, endgrent: get group file entry, getgrent,.getgrent(3) 

getpwnam, setpwent, endpwent: get password file entry, getpwent, getpwuid, ............ getpwent(3) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

uxrc: configuration file for kernel. • * •.. . . . . uxrc(8) 

open: open a file for reading or writing, or create a new file. • . . . . open(2) 

aliases: aliases file for send mail. ..aiiases(5) 

uuencode,uudecode: encode/decode a binary file for transmission via mail.... . uuencode(lC) 

ar: archive (library) file format.. ..ar(5) 

tar: tape archive file format. • • •.. tar(5) 

sccstorcs: build RCS file from SCCS file.accstorcs(l) 

sees tores: build RCS file from SCCS file.. sccstorcs(8) 

which: locate a program file including aliases and paths (cth only). • •«•••• which(l) 

fsplit: split a multi-routine Fortran file into individual files. • • • •.. . . . fsplit(l) 

split: split a file into pieces. .split(l) 

merge: three-way file merge.. merge(l) 

pmerge: pascal file merger...pmerge(l) 

mktemp: make a unique file name. .••••••••• .mktemp(3) 

fseek, ftell: reposition a file on a logical unit. . • • •. fseek(3F) 

more, page: file perusal filter for ert viewing.more(l) 

stat, lstat, fstat: get file status. ..... . stat(2) 

stat, lstat, fstat: get file status.stat(3F) 

mkproto: construct a prototype file system. .....mkproto(8) 

mount, umount: mount or remove file system. .. ... mount(2) 

mount, umount: mount and dismount file system. ....mount(8) 

newfs: construct a new file system. ..newfs(8) 

repquota: summarize quotas for a file system...repquota(8) 

setquota: enable/disable quotas on a file system. ... setquota(2) 

tunefs: tune up an existing file system...tunefs(8) 

repair, fsck: file system consistency check and interactive .. fsck(8) 

getfsfile, getfstype, setfsent, endfsent: get file system descriptor file entry, /getfsspec, .. getfsent(3X) 

dcheck: file system directory consistency check. •••••••• dcheck(8) 

dump: incremental file system dump...dump(8) 

rdump: file system dump across the network.rdump(8C) 

rrestore: restore a file system dump across the network. .rrestore(8C) 

hier: file system hierarchy...hier(7) 

dumpfs: dump file system information. ..dumpfs(8) 

quot: summarize file system ownership.. quot(8) 

quotacheck: file system quota consistency checker.quotacheck(8) 

quotaon, quotaoff: turn file system quotas on and off. •••••• .. quotaon(8) 

restore: incremental file system restore...restore(8) 

icheck: file system storage consistency check.. icheck(8) 

mtab: mounted file system table.. mtab(S) 

fs, inode: format of file system volume. ..fs(5) 

mkfs: program to make UNIX file systems. ... mkfs(8) 

utime: set file times. ....... utime(3C) 

utimes: set file times. ....utimes(2) 

uusend: send a file to a remote host.. uusend(lC) 

truncate: truncate a file to a specified length. •••••.•••• truncate(2) 

kermit: kermit file transfer.. kermit(l) 

ftp: file transfer program.. ftp(lC) 

tftp: trivial file transfer program. ••••• .tftp(lC) 

ftpd: DARPA Internet File Transfer Protocol server.ftpd(8C) 

tftpd: DARPA Trivial File Transfer Protocol server.tftpd(8C) 

file: determine file type.file(l) 

basename: strip filename affixes. ..basename(l) 

glob: filename expand argument list...csh(l) 

ferror, feof, clearerr, fileno: stream status inquiries.. ferror(3S) 

cbecknr: check nroff/troff files.. checknr(l) 

emp: compare two files. . cmp(l) 

comm: select or reject lines common to two sorted files.. comm(l) 

find: find files.find(i) 

split a multi-routine Fortran file into individual files, fsplit: ..... fsplit(l) 

ident: identify files...ident(l) 

lockf: record locking on files.lockf(3C) 

makedev: make system special files.... makedev(8) 

mv: move or rename files. .. ••••••••• mv(l) 

print log messages and other information about RCS files, rlog:...rlog(l) 

rmdir, rm: remove (unlink) directories or files. ..rmdir(l) 

sort: sort or merge files...sort(l) 

compact, uncompact, ccat: compress and uncompress files, and cat them.. ..compact(l) 

caiman: create the cat files for the manual. ...caiman (8) 
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tac: concatenate and print files in reverse order. ..tac(l) 

fsync: synchronize a file's in-core state with that on disk. • ..fsync(2) 

rm, rmdir: remove (unlink) files or directories.rm(l) 

sticky: executable files with persistent text. •.. . . sticky(8) 

fstab: static information about the filesystems. • »•••...••.••••••••• fstab(S) 

more, page: file perusal filter for ert viewing. • • •.more(l) 

eolert: filter nroff output for CRT previewing.colcrt(l) 

col: filter reverse line feeds. ..col(l) 

plot: graphics filters. • . . • •.plot(lG) 

refer: find and insert literature references in documents. • • • refer(l) 

find: find files. • . . ..find(l) 

find: find files. • .flnd(l) 

look: find lines in a sorted list.look(l) 

manual, man: find manual information by keywords; print out the • • man(l) 

tty name, isatty, ttyslot: find name of a terminal.• •.ttyname(3) 

ttynam, isatty: find name of a terminal port.. • . . ttynamf3F) 

(order: find ordering relation for an object library. • ••••• lorder(l) 

lookbib: build inverted index for a bibliography, find references in a bibliography, indxbib, ..lookbib(l) 

spell, spellin, spellout: find spelling errors. . ..speil(l) 

binary, file, strings: find the printable strings in a object, or other .strings(l) 

chfn: change finger entry.• ••••••••• chfn(l) 

finger: user information lookup program. • ..finger(l) 

fold: fold long lines for finite width output device.• ••••• foid(l) 

tmail: print out mail messages, most recent first. • • •.. tmail(l) 

head: give first few lines... head(l) 

dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines. •••••••• dbm(3X) 

fish: play “Go Fish”.... fish(6) 

fish: play “Go Fish”.fish(6) 

nice, nohup: run a command at low priority ($h only).. nice(l) 

extreme values, flmin, flmax, ffrac, dflmin, dflmax, dffrac, inmax: return • • • • flmin(3F) 

return extreme values, flmin, flmax, ffrac, dflmin, dflmax, dffrac, inmax: • • • • flmin(3F) 

fpu: determine presence of the floating point coprocessor. •••• fpu(l) 

trpfpe, fpeent: trap and repair floating point faults...trpfpe(3F) 

trapov: trap and repair floating point overflow. . . trapov(3F) 

file, flock: apply or remove an advisory lock on an open . • • fiock(2) 

functions, fabs, floor, ceil: absolute value, floor, ceiling .floor(3M) 

fabs, floor, ceil: absolute value, floor, ceiling functions. ... floor(3M) 

fclose, fflush: close or flush a stream. ..fclose(3S) 

flush: flush output to a logical unit.flush(3F) 

flush: flush output to a logical unit. ..flush(3F) 

exit: terminate a process after flushing any pending output.exit(3) 

fmt: simple text formatter. ..fmt(l) 

device, fold: fold long lines for finite width output ...•••• fold(l) 
fold: fold long lines for finite width output device. •••••• fold(l) 

bugfiler: file bug reports in folders automatically.. bugfiler(8) 

fopen, freopen, fdopen: open a stream.. fopen(3S) 

foreach: loop over list of names. • • • ... csh(l) 

fg: bring job into foreground. ..csh(l) 

fork: create a copy of this process. .fork(3F) 

fork: create a new process. ... fork(2) 

idate, itime: return date or time in numerical form. • .. ••••••• idate(3F) 

dmesg: collect system diagnostic messages to form error log. . ••••• dmesg(8) 

ar: archive (library) file format.... ar(5) 

dump, dumpdates: incremental dump format.. • • . • dump(5) 

tar: tape archive file format. ••••• tar(5) 

indent: indent and format C program source. •••••••• indent(l) 

htable: convert NIC standard format host tables. ... htable(8) 

gettable: get NIC format host tables from a host.gettable(8C) 

uuencode: format of an encoded uuencode file.uuencode(5) 

dir: format of directories. .. dir(5) 

fs, inode: format of file system volume. .fs(5) 

core: format of memory image file.. •••• core(5) 

rcsfile: format of RCS file.rcsfile(5) 

tbl: format tables for nroff or troff. •••••••••••• tbl(l) 

scanf, fscanf, sscanf: formatted input conversion.scanf(3S) 

printf, fprintf, sprintf: formatted output conversion.. printf(3S) 

dkfmt: standalone disk formatter. *.dkfmt(8) 

fmt: simple text formatter.... fmt(l) 

nroff: text formatting.nroff(l) 

troff, nroff: text formatting and typesetting...troff(l) 

ms: text formatting macros...ms(7) 

me: macros for formatting papers.me(7) 

f77: Fortran 77 compiler.. f77(l) 

ratfor: rational Fortran dialect...ratfor(l) 

fpr: print Fortran file.. fpr(l) 
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fsplit: split a multi-routine 
efl: Extended 
intro: introduction to 
putc, fputc: write a character to a 
struct: structure 
adage. 

login,/ sh, for, case, if, while, t, • 
exit, export,/ sh, for, case, if, while, s 

compiler/interpreter. 

trpfpe, 

printf, 
coprocessor, 
putc, putchar, 
putc, 
puts, 

liszt: compile a 

df: disk 
malloc, 
fopen, 
exponent, 
from: who is my mail 

scanf, 

mklost+found: make a lost+found directory for 

repair. 


individual files. 

stat, Istat, 
stat, Istat, 
on disk, 
fseek, 
fseek, 
time, 


shutdown: shut down part of a 
gamma: log gamma 
compiler/interpreter, fp: 
hit: and, or, xor, not, rshift, lshift bitwise 
fabs, floor, ceil: absolute value, floor, ceiling 
intro: introduction to library 
intro: introduction to compatibility library 
intro: introduction to FORTRAN library 
intro: introduction to mathematical library 
intro: introduction to network library 
intro: introduction to miscellaneous library 
jO, jl, jn, yO, yl, yn: bessel 
cos, tan, asin, acos, atan, atan2: trigonometric 
sinh, cosh, tanh: hyperbolic 
bessel 
curses: screen 
fread, 

aardvark: yet another exploration 
adventure: an exploration 
backgammon: the 
battlestar: a tropical adventure 
hunt: a multi-player multi-terminal 
monop: Monopoly 
snake, snscore: display chase 
trek: trekkie 
worm: Play the growing worm 
canfield, cfscores: the solitaire card 
cribbage: the card 
hangman: Computer version of the 
boggle: play the 
wump: the 
gamma: log 


ecvt, fevt, 
buffers, kgmon: 


Fortran file into individual files. .. 

Fortran Language. ••.•••••••••••••• 

FORTRAN library functions. .. 

fortran logical unit.. . . . .. 

Fortran programs. .... 

fortune: print a random, hopefully interesting, . 

, break, continue, cd, eval, exec, exit, export, • •••». 

, ., break, continue, cd, eval, exec, ... . 

fp: Functional Programming language.. • • . 

fpeent: trap and repair floating point faults. 

fpr: print Fortran file.. 

fprintf, sprintf: formatted output conversion. 

fpu: determine presence of the floating point.. 

fputc, putw: put character or word on a stream. • • • • 
fputc: write a character to a fortran logical unit. • • • . 

fputs: put a string on a stream. • .. 

Franz Lisp program. ... . . . 

fread, fwrite: buffered binary input/output. 

free. ... 

free, realloc, calloc, allocs: memory allocator. •••••• 

freopen, fdopen: open a stream. .. . . . 

frexp, Id exp, modf: split into mantissa and • .. 

from?... 

fs, inode: format of file system volume. .»•••••• 

fscanf, sscanf: formatted input conversion. 

fsek. .... 

fsck: file system consistency check and interactive • • • • 

fseek, ftell: reposition a file on a logical unit. 

fseek, ftell, rewind: reposition a stream.. 

fsplit: split a multi-routine Fortran file into •••••• 

fstab: static information about the filesystems. • • • • • 

fstat: get file status. .. 

fstat: get file status. ••••••••••••••.. 

fsync: synchronize a file’s in-core state with that • • • • 

ftell: reposition a file on a logical unit. 

ftell, rewind: reposition a stream. .. 

ftime: get date and time. 

ftp: file transfer program. ••••••••.••••• 

ftpd: DARPA Internet File Transfer Protocol server. . • 

full-duplex connection. .. 

function. . .... 

Functional Programming language . 

functions. .... 

functions... 

functions. ..... 

functions. ... 

functions. ... . .. 

functions. ... 

functions. .. 

functions. .... 

functions... 

functions, sin, 

functions.. 

functions: of two kinds for integer orders. 

functions with “optimal” cursor motion. 

fwrite: buffered binary input/output. ......... 

game... 

game. 

game. . . .... 

game. 

game... 

game. 

game... 

game. 

game... 

game canfield.. . . ... 

game cribbage. .. 

game hangman. 

game of boggle. .. 

game of hunt-the-wumpus. 

gamma function. 

gamma: log gamma function. 

gcore: get core images of running processes. 

gevt: output conversion... 

generate a dump of the operating system’s profile . • • • 


fsplit(l) 

efl(l) 

intro(3F) 

putc(3F) 

struct(l) 

fortune(6) 

sb(l) 

ah(l 

rp(i) 

trpfpe(3F) 

fpr(l) 

printf(3S) 

fpu(l) 

putc(3S) 

putc(3F) 

puts(3S) 

liszt(l) 

fread (3S) 

df(l) 

malloc(3) 

fopen(3S) 

frexp(3) 

from(l) 

fs(5) 

scanf(3S) 
mklost+found(8) 
fsck (8) 
fseek(3F) 
fseek(3S) 
fsplit(l) 
fstab (5) 
stat(2) 

8tat(3F) 

fsync(2) 

fseek(3F) 

fseek(3S) 

time(3C) 

ftp(lC) 

ftpd(8C) 

shutdown (2) 

gamma(3M) 

fp(i) 

bit(3F) 

floor(3M) 

intro(3) 

intro(3C) 

intro(3F) 

intro(3M) 

intro(3n) 

intro(3X) 

jO(3M) 

sin(3M) 

sinh(3M) 

bessel(3F) 

curses(3X) 

fread(3S) 

aardvark(6) 

adventure(fi) 

backgammon (6) 

battlestar(6) 

hunt(6) 

monop(6) 

snake(6) 

trek(6) 

worm (6) 

canfield(6) 

cribbage(6) 

hangman(6) 

boggle(6) 

wump(6) 

gamma(3M)' 

gamma(3M) 

gcore(l) 

ecvt(3) 

kgmon(8) 
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abort: generate a fault.abort(3) 

makekey: generate encryption key.makekey(8) 

ncheck: generate names from i>numbers. . • . . ..ncheck(8) 

rand, srand: random number generator.rand(3C) 

lex: generator of lexical analysis programs.lex(l) 

/srandom, initstate, setstate: better random number generator; routines for changing generators.random(3) 

random number generator; routines for changing generators, /srandom, initstate, setstate: better • • • • random(3) 

perror, gerror, iermo: get system error messages. ..perror(3F) 

getarg, large: return command line arguments.getarg(3F) 

getc, fgetc: get a character from a logical unit.getc(3F) 

from stream, getc, getchar, fgetc, getw: get character or word . . . . getc(3S) 

stream, getc, getchar, fgetc, getw: get character or word from • . • • getc(3S) 

getewd: get pathname of current working directory. • • • getcwd(3F) 

getdiskbyname: get disk description by its name.getdisk(3X) 

getdtablesize: get descriptor table size. • • • •.getdtablesize(2) 

getgid, getegid: get group identity. . getgid(2) 

getenv: get value of environment variables.getenv(3F) 

getenv: value for environment name.• • • • • getenv(3) 

getuid, geteuid: get user identity. .getuid(2) 

setfsent, endfsent: get file system descriptor/ getfsent, getfsspec, getfsfile, getfstype, ..getfsent(3X) 

system descriptor file entry, getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent: get file • ••••• getfsent(3X) 

endfsent: get file system descriptor/ getfsent, getfsspec, getfsfile, getfstype, setfsent,.getfsent(3X) 

descriptor file/ getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent: get file system .getfsent(3X) 

getuid, getgid: get user or group ID of the caller. • getuid(3F) 

getgid, getegid: get group identity.getgid(2) 

get group file entry, getgrent, getgrgid, getgrnam, setgrent, endgrent: • . • • getgrent(3) 

file entry, getgrent, getgrgid, getgrnam, setgrent, endgrent: get group • • • . getgrent(3) 

getgrent, getgrgid, getgrnam, setgrent, endgrent: get group file entry. • . • getgrent(3) 

getgroups: get group access list. • ••... .getgroups(2) 

endhoetent: get network host entry, gethostent, gethostbyaddr, gethostbyname, setbostent, ..gethostent(3n) 

host entry, gethostent, gethostbyaddr, gethostbyname, sethostent, endhostent: get network • • gethostent(3n) 
sethostent, endhostent: get network host entry, gethostent, gethostbyaddr, gethostbyname, • ••••• gethostent(3n) 

current host, gethostid, sethostid: get/set unique identifier of .... gethostid(2) 

host, gethostname, sethostname: get/set name of current • • • gethostname(2) 

timer, getitimer, setitimer: get/set value of interval .getitimer(2) 

getlog: get user’s login name.getlog(3F) 

getlogin: get login name...getlogin(3) 

get network entry, getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent: • • • getnetent(3n) 
entry, getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent: get network .... getnetent(3n) 
endnetent: get network entry, getnetent, getnetbyaddr, getnetbyname, setnetent, ... getnetent(3n) 

getpagesize: get system page size...getpagesize(2) 

getpass: read a password. ..getpass(3) 

getpeername: get name of connected peer.getpeername(2) 

getpgrp: get process group.getpgrp(2) 

getpid: get process id.. • • • getpid(3F) 

getpid, getppid: get process identification.getpid(2) 

getpid, getppid: get process identification. • ••••••••• getpid(2) 

scheduling priority, getpriority, setpriority: get/set program ........ getpriority(2) 

protocol entry, getprotoent, getprotobynumber, get protobyname, setprotoent, endprotoent: get . . • • • getprotoent(3n) 
endprotoent: get protocol entry, getprotoent, getprotobynumber, get protobyname, setprotoent, .... getprotoent(3n) 

setprotoent, endprotoent: get protocol entry, getprotoent, getprotobynumber, get protobyname, . . . . getprotoent(3n) 

getpw: get name from uid...getpw(3C) 

get password file entry, getpwent, getpwuid, getpwnam, setpwent, endpwent: . . getpwent(3) 

entry, getpwent, getpwuid, getpwnam, setpwent, endpwent: get password file • . . . getpwent(3) 

password file entry, getpwent, getpwuid, getpwnam, setpwent, endpwent: get.getpwent(3) 

resource consumption, getrlimit, setrlimit: control maximum system .••••• getrlimit(2) 

utilization, getrusage: get information about resource .getrusage(2) 

gets, fgets: get a string from a stream. ..••••.. gets(3S) 
entry, getservent, getservbyport, getservbyname, setservent, endservent: get service • • . getservent(3n) 

endservent: get service entry, getservent, getservbyport, getservbyname, setservent, .getservent(3n) 

setservent, endservent: get service entry, getservent, getservbyport, getservbyname.getservent(3n) 

gettimeofday, settimeofday: get/set date and time.. • . gettimeofday(2) 

gethostname, sethostname: get/set name of current host. .gethostname(2) 

getpriority, setpriority: get/set program scheduling priority.getpriority(2) 

gethostid, sethostid: get/set unique identifier of current host. .gethostid(2) 

getitimer, setitimer: get/set value of interval timer.. getitimer(2) 

getsockname: get socket name. ..getsockname(2) 

sockets, getsockopt, setsockopt: get and set options on ..... getsockopt(2) 

gettable: get NIC format host tables from a host.gettable(8C) 

gettimeofday, settimeofday: get/set date and time. • . . gettimeofday(2) 

getty: set terminal mode.getty(8) 

gettytab: terminal configuration data base. .gettytab(5) 

getuid, geteuid: get user identity. ..getuid(2) 

getuid, getgid: get user or group ID of the caller.getuid(3F) 

getc, getchar, fgetc, getw: get character or word from stream.getc(3S) 
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getwd: get current working directory pathname. • • • • getwd(3) 

head: give first few lines. ....head(l) 

shutdown: close down the system at a given time. ......shutdown(8) 

glob: filename expand argument list.csh(l) 

ASCII, ctime, localtime, gmtime, asetime, timezone: convert date and time to . • ctime(3) 

time, ctime, ltime, gmtime: return system time...time(3F) 

fish: play “Go Fish”. . ....fish(6) 

setjmp, longjmp: non-local goto...setjmp(3) 

goto: command transfer.csh(l) 

gprof: display call graph profile data. • •••••••• gprof(l) 

graph: draw a graph. ....graph(lG) 

graph: draw a graph. . . ..graph(lG) 

gprof: display call graph profile data. ..... . gprof(l) 

plot: graphics filters.....plot(lG) 

arc, move, cont, point, linemod, space, closepi: graphics interface, /erase, label, line, circle.plot(3X) 

plot: graphics interface...plot(5) 

lib2648: subroutines for the HP 2548 graphics terminal.. . ..iib2648(3X) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

ygrind: grind nice listings of programs.vgrind(l) 

chgrp: change group. • •.. chgrp(l) 

getpgrp: get process group. • • ..getpgrp(2) 

killpg: send signal to a process group. ... killpg(2) 

setpgrp: set process group.. setpgrp(2) 

getgroups: get group access list. getgroups(2) 

initgroups: initialize group access list. . initgroups(3X) 

setgroups: set group access list. ..setgroups(2) 

group: group file. .group(5) 

getgrgid, getgrnam, setgrent, endgrent: get group file entry, getgrent, ..getgrent(3) 

group: group file. • • • ..group(5) 

setregid: set real and effective group ID...... . setregid(2) 

setruid, setgid, setegid, setrgid: set user and group ID. setuid, seteuid, .. setuid(3) 

getuid, getgid: get user or group ID of the caller. ..getuid(3F) 

getgid, getegid: get group identity...getgid(2) 

groups: show group memberships. ..groups(l) 

chown: change owner and group of a file..... chown(2) 

make: maintain program groups. ..make(l) 

\ groups: show group memberships.groups(l) 

worm: Play the growing worm game. .. worm(6) 

stty, gtty: set and get terminal state (defunct). stty(3C) 

stop: halt a job or process. •••• ...csh(l) 

reboot: reboot system or halt processor. •••••••• .reboot(2) 

halt: stop the processor....halt(8) 

rmail: handle remote mail received via uucp.. rmail(l) 

re_.com p, re_exec: regular expression handler. .... regex(3) 

hangman: Computer version of the game hangman.. hangman(6) 

hangman: Computer version of the game hangman. ... hangman(6) 

yhangup: virtually “hangup” the current control terminal.. vhangup(2) 

nohup: run command immune to hangups. ...csh(l) 

crash: what happens when the system crashes.. crash(8V) 

park: program to park the hard disk heads.. park(8) 

link: make a hard link to a file.... link(2) 

rehash: recompute command bash table... •••• csh(l) 

unhash: discard command hash table.. . . ... • • • csh(l) 

hashstat: print command bashing statistics.csh(l) 

hashstat: print command hashing statistics.csh(l) 

leave: remind you when you have to leave...leave(l) 

park: program to park the hard disk heads. ....park(8) 

od: octal, decimal, hex, ascii dump.. ..od(l) 

hier: file system hierarchy. • ..hier(7) 

hier: file system hierarchy...hier(7) 

history: print history event list.csh(l) 

history: print history event list. ••••••••••• csh(l) 

fortune: print a random, hopefully interesting, adage...fortune(6) 

sethostid: get/set unique identifier of current host, gethostid, ... gethostid(2) 

gethostname, sethostname: get/set name of current host. ....gethostname(2) 

gettable: get NIC format host tables from a host.gettable(8C) 

hostnm: get name of current host...hostnm(3F) 

uusend: send a file to a remote host...uusend(lC) 

htonl, htons, ntohl, ntohs: convert values between host and network byte order.byteorder(3n) 

remote: remote host description file.. • • • . remote(b) 

gethostbyname, sethostent, endhostent: get network host entry, gethostent, gethostbyaddr, .gethostent(3n) 

hosts: host name data base.hosts(5) 

phones: remote host phone number data base. . ... . phone$(5) 

ruptime: show host status of local machines.. • • • ruptime(lC) 

hostid: set or print identifier of current host system.. . . ..hostid(l) 

xxxii ICON INTERNATIONAL 










































































Permuted Index 


hostname: set or print name of current host system...hostname(l) 

htable: convert NIC standard format host tables.. htable(8) 

get table: get NIC format host tables from a host. • • • •.• • . . gettable(8C) 

system, hostid: set or print identifier of current host ...... hostid(l) 

hostname: set or print name of current host system. • . hostname(l) 

hostnm: get name of current host.hostnm(3F) 

ping: send ICMP ECHOJtEQUEST packets to network hosts. ... ping(8) 

hosts: ho6t name data base. • • •.• • • • hosts(S) 

uptime: show how long system has been up.uptime(l) 

TEACHJOVE - learn how to use the JOVE editor. • ••.•••• .teachjove(l) 

lib2648: subroutines for the HP 2648 graphics terminal. ..lib2648(3X) 

htable: convert NIC standard format host tables. . • • . htable(8) 

host and network byte order, htonl, htons, ntohl, ntohs: convert values between • . • byteorder(3n) 

and network byte order, htonl, htons, ntohl, ntohs: convert values between host • • • • byteorder(3n) 

hunt: a multi-player multi-terminal game.hunt(6) 

wump: the game of hunt-the-wumpus.. wump(6) 

sinh, cosh, tanh: hyperbolic functions.. sinh(3M) 

hypot, cabs: Euclidean distance. ..hypot(3M) 

getarg, iarge: return command line arguments.getarg(3F) 

icheck: file system storage consistency check.icheck(8) 

ping: send ICMP ECHOJIEQUEST packets to network hosts. • . ping(8) 

getpid: get process id. • •»••••• .. getpid(3F) 

a message queue, semaphore set or shared memory id. iperm: remove .. . . . ipcrm(l) 

setregid: set real and effective group ID. .setregid(2) 

setgid, setegid, setrgid: set user and group ID. setuid, seteuid, setruid, .setuid(3) 

whoami: print effective current user id. •.whoami(l) 

getuid, getgid: get user or group ID of the caller. ...getuid(3F) 

su: substitute user id temporarily...su(l) 

form, idate, itime: return date or time in numerical . • • • • idate(3F) 

ident: identify files.• . ident(l) 

getpid, getppid: get process identification...getpid(2) 

getho6tid, setbo6tid: get/set unique identifier of current host. .gethostid(2) 

hostid: set or print identifier of current host system.• • • • . hostid(l) 

ident: identify files...• • ident(l) 

getgid, getegid: get group identity.getgid(2) 

getuid, geteuid: get user identity. ..getuid(2) 

setreuid: set real and effective user ID’s.. setreuid(2) 

perror, gerror, ierrno: get system error messages. ..perror(3F) 

if: conditional statement.csh(l) 

biff: be notified if mail arrives and who it is from.biff(l) 

eval, exec, exit, export, login,/ sh, for, case, if, while, : , . , break, continue, cd, • .sh(l) 

ifeonfig: configure network interface parameters. • . • • ifconflg(8C) 

unifdef: remove ifdef’ed lines.unifdef(l) 

abort: terminate abruptly with memory image. ... • • • abort(3F) 

core: format of memory image file.... core(S) 

gcore: get core images of running processes.. gcore(l) 

notify: request immediate notification. •••••.••••• csh(l) 

nohup: run command immune to hangups. ...csh(l) 

implog: IMP log interpreter. implog(8C) 

implogd: IMP logger process. ••••• implogd(8C) 

xstr: extract strings from C programs to implement shared strings..xstr(l) 

implog: IMP log interpreter. ...implog(8C) 

implogd: IMP logger process..implogd(8C) 

eyacc: modified yacc allowing much improved error recovery.... eyacc(l) 

which: locate a program file including aliases and paths (cM only ).. which(l) 

fsync: synchronize a file’s in-core state with that on disk.fsync(2) 

dump, dumpdates: incremental dump format.dump(5) 

dump: incremental file system dump.dump(8) 

restore: incremental file system restore. .. restore(8) 

indent: indent and format C program source.indent(l) 

indent: indent and format C program source. • • • • • indent(l) 

tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation routines, tgetent.termcap(3X) 

ptx: permuted index. ... ptx(l) 

bibliography, indxbib, lookbib: build inverted index for a bibliography, find references in a .. lookbib(l) 

objects, index, rindex, lnblnk, len: tell about character • • . • • index(3F) 

strncat, stremp, strnemp, strepy, strnepy, strlen, index, rindex: string operations, streat, .string(3) 

last: indicate last logins of users and teletypes.last(l) 

syscal): indirect system call.syscall(2) 

fsplit: split a multi-routine Fortran file into individual files. ••••.•••.•••• fsplit(l) 

bibliography, find references in a bibliography, indxbib, lookbib: build inverted index for a .lookbib(l) 

inetjnaof, inet_netof: Internet address/ inet_addr, inet_network, inet.ntoa, inet_makeaddr, • . . inet(3n) 

inet_addr, inet_network, inet_ntoa, inet^makeaddr, inetjnaof, inet.netof: Internet address/.inet(3n) 

address/ inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet jnaof, inet_netof: Internet • • • • • inet(3n) 

/inet^network, inet_ntoa, inet^makeaddr, inetjnaof, inet^netof: Internet address manipulation routines. . . . inet(3n) 

inet_netof: Internet address/ inet^ddr, inet.network, inet.ntoa, inet^makeaddr, inetjnaof, • . inet(3n) 
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Internet address/ inet_addr, inet_network, 
durnpfs: dump file system 
mttys: Multi-link partition 
pac: printer/plotter accounting 
whodos: display 
riog: print log messages and other 
getrusage: get 
▼times: get 
fstab: static 
man: find manual 
dosdisk: program to create and display 
finger: user 

miscellaneous: miscellaneous useful 


init: process control 
ioinit: change 177 I/O 
tset: terminal dependent 
ttys: terminal 
initgroups: 
connect: 
popen, pclose: 

generator; routines for changing/ random, srandom, 
flmin, Umax, ffrac, dflmin, dfimax, dffrac, 

clri: clear 

fs, 

read,readv: read 
soelim: eliminate .so’s from nrofi 
scanf, fscanf, sscanf: formatted 
ungetc: push character back into 
fread, fwrite: buffered binary 
stdio: standard buffered 
ferror, feof, clearerr, fileno: stream status 
refer: find and 
insque, remque: 

install: 
binstl: program to 

learn: computer aided 
doctor: 
jove: an 

fsck: file system consistency check and 
fortune: print a random, hopefully 
cont, point, linemod, space, closepl: graphics 

plot: graphics 
tty: general terminal 
ifeonfig: configure network 
telnet: user 

slattach: attach serial lines as network 
sendmail: send mail over the 
/inet_ntoa, inet_makeaddr, inetjnaof, inet_netof: 

ftpd: DARPA 
spline: 
implog: IMP log 
lisp: lisp 
pti: phototypesetter 
px: Pascal 
pix: Pascal 
pi: Pascal 
esh: a shell (command 
pipe: create an 
ipcs: report 

atomically release blocked signals and wait for 

onintr: process 
intro: 
intro: 
intro: 
intro: 
intro: 
intro: 
intro: 
rcsintro: 
intro: 

commands, intro: 


inet_ntoa, inet_makeaddr, inetjnaof, inet_netof: . . . . 

information... 

information. • •••••• .. 

information. 

information about dose users. 

information about RCS files. • • • • •. 

information about resource utilization. . .. 

information about resource utilization. .. 

information about the filesystems. .. 

information by keywords; print out the manual. 

information for MPS/DOS vdisks. • .. 

information lookup program. .. 

information pages. .. . . . 

init: process control initialization.. 

initgroups: initialize group access list. 

initialization... 

initialization... 

initialization. •.. . . . 

initialization data... 

initialize group access list. .. 

initiate a connection on a socket. • • ... . . 

initiate I/O to/from a process. • • • •. 

initstate, setstate: better random number *.....; 

inmax: return extreme values. .. 

i-node. •.... 

inode: format of file system volume.. 

input. .. 

input. • .. 

input conversion..... 

input stream. • • •.• • •. 

input/output.. • • .. 

input/output package. .. 

inquiries. . • • • .... 

insert literature references in documents. • •••••• 

insert/remove element from a queue.. 

insque, remque: insert/remove element from a queue. • . 

install binaries. • •••.•••••••• . 

install bootloader on disk. • . . .. 

install: install binaries. .. 

instruction about UNIX. 

interact with a psychoanalyst. . ... . . • . 

interactive display-oriented text editor. 

interactive repair. ... 

interesting, adage. 

interface, /erase, label, line, circle, arc, move, . . . . . 

interface. ..... 

interface. • •.... 

interface parameters. • ••••••• . 

interface to the TELNET protocol. • 

interfaces.. 

internet.... 

Internet address manipulation routines. •••••••• 

Internet File Transfer Protocol server. 

interpolate smooth curve... 

interpreter. • • • .... 

interpreter. • .. ••••••••••••• 

interpreter. 

interpreter. .. 

interpreter and executor. 

interpreter code translator... 

interpreter) with C-like syntax. ••••••••.••• 

interprocess communication channel.. • . 

inter-process communication facilities status. 

interrupt, sigpause: ••••••••• . 

interrupts in command scripts. .. •••• 

introduction to commands.. 

introduction to compatibility library functions. • • • • • 

introduction to FORTRAN library functions. 

introduction to library functions. •••••• . 

introduction to mathematical library functions. 

introduction to miscellaneous library functions. 

introduction to network library functions.. • • 

introduction to RCS commands. • .. 

introduction to system calls and error numbers. • • • . 
introduction to system maintenance and operation . . • 


inet(3n) 

dumpfs(8) 

mttys(5) 

pac(8) 

whodos(l) 

rlog(l) 

getrusage(2) 

rtimes(3C) 

fstab (S) 

man(l) 

dosdisk(8) 

finger(l) 

intro(7) 

init(8) 

initgroups(3X) 

init(8) 

idnit(3F) 

tset(l) 

ttys(5) 

initgroups(3X) 

connect (2) 

popen(3) 

random(3) 

flmin(3F) 

clri(8) 

fs(5) 

read(2) 

soelim(l) 

scanf(3S) 

ungetc(3S) 

fread (3S) 

intro(3S) 

ferror(3S) 

refer(l) 

insque(3) 

insque(3) 

install (1) 

binstl(8) 

install(l) 

learn(l) 

doctor(6) 

jove(l) 

fsck (8) 

fortune(6) 

plot(3X) 

plot(5) 

tty (4) 

ifconfig(8C) 

telnet (1C) 

slattach(8C) 

sendmail(8) 

inet(3n) 

ftpd(8C) 

spline(lG) 

implog(8C) 

lisp(l) 

pti(l) 

px(l) 

pix(l) 


pipe(2) 

ipcs(l) 

sigpause(2) 

csh(l) 

intro(l) 

intro(3C) 

introf3F) 

intro(3) 

intro(3M) 

intro(3X) 

intro(3n) 

rcsintro(l) 

intro(21 

intro(8) 
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ncbeck: generate names from i-numbers...ncheck(8) 

in a bibliography, indxbib, lookbib: build inverted index for a bibliography, find references * • • • lookbib(l) 

tread, twrite, trewin, tskipf, tstate: f77 tape I/O. topen, tclose, .topen(3F) 

ioinit: change 177 I/O initialization. . • • •.• • • . • ioinit(3F) 

select: synchronous i/o multiplexing.select(2) 

iostat: report I/O statistics.. iostat(l) 

popen, pclose: initiate I/O to/from a process. .• • • . ..popen(3) 

ioctl: control device. ....ioctl(2) 

ioinit: change f77 I/O initialization. • . • ..ioinit(3F) 

iostat: report I/O statistics. • ....•••.•••. io6tat(l) 
shared memory id. iperm: remove a message queue, semaphore set or • • • • ipcrm(l) 

status, ipcs: report interprocess communication facilities • • . • ipcs(I) 

rand, drand, irand: return random values.rand(3F) 

isascii:/ isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, .ctype(3) 

isspace, ispunct, isprint, iscntrl, isascii:/ isalpha, isupper, islower, isdigit, isalnum.ctype(3) 

isalnum, isspace, ispunct, isprint, iscntrl, isascii: character classification macros, /isdigit.ctype(3) 

ttynam, isatty: find name of a terminal port.ttynam(3F) 

ttyname, isatty, ttyslot: find name of a terminal. . . ..ttyname(3) 

/isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii: character classification macros.ctype(3) 

iscntrl, isascii:/ isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, isprint.ctype(3) 

isprint, iscntrl, isascii:/ isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, • •••••• ctype(3) 

/islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii: character classification/ ctype(3) 

/isupper, islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii: character/ • ctype(3) 

isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii:/ • ••••••• ctype(3) 

system: issue a shell command. •.. system(3) 

ispunct, isprint, iscntrl, isascii:/ isalpha, isupper, islower, isdigit, isalnum, isspace.ctype(3) 

idate, itime: return date or time in numerical form. ...... idate(3F) 

jO, jl, jn, yO, yl, yn: bessel functions. • ••••••.. jO(3M) 

jO, jl, jn, yO, yl, yn: bessel functions. • •••....•• jO(3M) 

jO, jl, jn, yO, yl, yn: bessel functions.. jO(3M) 

bg: place job in background. •••••• csh(l) 

fg: bring job into foreground.csh(l) 

jobs: print current job list.... csh(l) 

stop: halt a job or process.csh(l) 

kill: kill jobs and processes. ..csh(l) 

lprm: remove jobs from the line printer spooling queue.lprm(l) 

jobs: print current job list.csh(l) 

join: relational database operator.join(l) 

jove: an interactive display-oriented text editor.jove(l) 

jove_recover - recover JOVE buffers after a system/editor crash.jove_recover(l) 

TEACHJOVE - learn how to use the JOVE editor. ... teachjove(l) 

system/editor crash. jove_recover - recover JOVE buffers after a .jove_recover(l) 

msgs: system messages and junk mail program...msgs(l) 

kermit: kermit file transfer... kermit(l) 

kermit: kermit file transfer. ••*.. kermit(l) 

uxrc: configuration file for kernel.... uxrc(8) 

vers: print version number of the kernel. ••••• vers(l) 

makekey: generate encryption key. ••••••••••• makekey(8) 

apropos: locate commands by keyword lookup. ...••••..•••• apropos(l) 

man: find manual information by keywords; print out the manual. ••••••• man(l) 

profile buffers, kgmon: generate a dump of the operating system’s • • • kgmon(8) 

kill: kill jobs and processes. •••••••• .csh(l) 

kill: kill jobs and processes. •••.••••••... cshfl) 

kill: send a signal to a process. •••••. .kill(3F) 

kill: send signal to a process. • kill(2) 

kill: terminate a process with extreme prejudice.kill(l) 

killpg: send signal to a process group.killpg(2) 

bessel functions: of two kinds for integer orders. ..bessel(3F) 

droem, kmem: main memory. ..mem(4) 

linemod, space, closepl:/ plot: openpl, erase, label, line, circle, arc, move, cont, point, ..plot(3X) 

awk: pattern scanning and processing language...awk(l) 

be: arbitrary-precision arithmetic language... bc(l) 

efi: Extended Fortran Language.efl(l) 

set, shift, times, trap, umask, wait: command language, /exit, export, login, read, readonly, .sh(l) 

fp: Functional Programming language compiler/interpreter. •••• .fp(l) 

vgrindefs: vgrind’s language definition data base. ..vgrindefs(5) 

order, lastcomm: show last commands executed in reverse • . • lastcomm(l) 

Id: link editor. • ld(l) 

frexp, Idexp, modf: split into mantissa and exponent. • . . . . frexp(3) 

learn: computer aided instruction about UNIX. • • • • • learn(l) 

TEACHJOVE - learn how to use the JOVE editor.teachjove(l) 

leave: remind you when you have to leave. ••••••••••• leave(l) 

leave: remind you when you have to leave. •.....• leave(l) 

exit: leave shell....csh(l) 

index, rindex, inblnk, len: tell about character objects.index(3F) 
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truncate: truncate a file to a specified 

lex: generator of 
terminal. 

ranlib: convert archives to random 
lorder: find ordering relation for an object 

ar: archive 
Intro: introduction to 
intro: introduction to compatibility 
intro: introduction to FORTRAN 
intro: introduction to mathematical 
intro: introduction to network 
intro: introduction to miscellaneous 
ar: archive and 

limit: alter per-process resource 
unlimit: remove resource 
quota: display disc usage and 
getarg, iarge: return command 
apace, cloeepl:/ plot: openpl, erase, label, 
eoi: filter reverse 
aysline: display system status cm status 

lpr: off 
lpc: 
Ipd: 

cleanlpd: clean 
lprm: remove jobs from the 
/erase, label, line, circle, arc, move, cont, point, 
head: give first few 
unifdef: remove ifdefed 
slattach: attach serial 
comm: select or reject 
fold: fold long 
uniq: report repeated 
look: find 
rev: reverse 

readlink: read value of a symbolic 

Id: 

a.out: assembler and 


link: make a hard 
symlink: make symbolic 
link: make a 
in: make 

lxref: 

lisp: 

liszt: compile a Franz 
glob: filename expand argument 
history: print history event 
jobs: print current job 
shift: manipulate argument 
getgroups: get group access 
initgroups: initialize group access 
look: find lines in a sorted 
nlist: get entries from name 
nm: print name 
setgroups: set group access 
symorder: rearrange name 
varargs: variable argument 
Is: 

dosdisks: 
foreach: loop over 
users: compact 
listen: 

vgrind: grind nice 

refer: find and insert 

index, rindex, 
bload: program to 


length. .. 

lex: generator of lexical analysis programs. • 
lexical analysis programs. • •*••••• 
lib2648: subroutines for the HP 2648 graphics 
libraries.. 

library... 

(library) file format. . . *. 

library functions. ... 

library functions.. 

library functions. ... . . . 

library functions.. 

library functions. ... . . . . 

library functions.*. 

library maintainer. . . ... . . 

limit: alter per-process resource limitations. 

limitations. .. . . . . 

limitiations. ... 

limits. .. 

line arguments. 

line, circle, arc, move, cont, point, linemod, 

line feeds. .. 

line of a terminal. .. . . 

line print.. 

line printer control program. . 

line printer daemon. 

line printer daemon environment. • • • • • 

line printer spooling queue. 

linemod, space, closepl: graphics interface. • 

lines. .. . 

lines.. . . . .. 

lines as network interfaces. ••••••• 

lines common to two sorted files. • • • • * 

lines for finite width output device. • • • • 

lines in a file.. 

lines in a sorted list. • • • • .. 

lines of a file. .. 

link.. . . . 

link editor. .. 

link editor output. ••••••••••• 

link: make a hard link to a file. 

link: make a link to an existing file. 

link to a file.. 

link to a file. ... • • • 

link to an existing file. .. 

links.. 

lint: a C program verifier. •••••••• 

lisp cross reference program. ••••••• 

lisp interpreter. .. 

lisp: lisp interpreter.. . . . 

Lisp program. ... 

list.. 

list. • 

list. .................. 

list.. • • • • 

list. 

list.. 

list.. 

list. . .. 

list. .. 

list. • • • . .. 

list. . 

list. 

list contents of directory. 

list of MPS/DOS virtual disks. • ••••• 

list of names... 

list of users who are on the system. 

listen for connections on a socket. 

listen: listen for connections on a socket. • . 

listings of programs... 

liszt: compile a Franz Lisp program. • . . 
literature references in documents. • • • . 

In: make links. 

Inblnk, len: tell about character objects. • . 

load standalone programs. 

loc: return the address of an object. 
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and time to ASCII, ctime, localtime, gmtime, asctime, timezone: convert date • • . ctime(3) 

(etAonly). which: locate a program file including aliases and paths • . • . which(l) 

apropos: locate commands by keyword lookup.. • • . • apropos(l) 

whereis: locate source, binary, and or manual for program. • • • whereis(l) 

end, etext, edata: last locations in program. . •.* • • • end(3) 

flock: apply or remove an advisory lock on an open file.... • . fiock(2) 

lock: reserve a terminal...• • lock(l) 

lockf: record locking on files.lockf(3C) 

lockf: record locking on files.lockf(3C) 

collect system diagnostic messages to form error log. dmesg: .. dmesg(8) 

syslog, openlog, clo6elog: control system log. ..syslog(3) 

gamma: log gamma function.. . . gamma(3M) 

implog: IMP log interpreter.... imp!og(8C) 

power, square root, exp, log, loglO, pow, sqrt: exponential, logarithm, ...••• exp(3M) 
rlog: print log messages and other information about RCS files. • • rlog(l) 

syslog: log systems messages. syslog(8) 

square root, exp, log, loglO, pow, sqrt: exponential, logarithm, power, • • . • exp(3M) 

exp, log, loglO, pow, sqrt: exponential, logarithm, power, square root.exp(SM) 

rwho: who’s logged in on local machines. • • rwho(lC) 

implogd: IMP logger process.....implogd(8C) 

flush: flush output to a logical unit. .. . • • flush(3F) 

fseek, ftell: reposition a file on a logical unit.. •.. fseck(3F) 

getc, fgetc: get a character from a logical unit...getc(3F) 

putc, fputc: write a character to a fortran logical unit. • • putc(3F) 

rlogin: remote login. .. • • •.rlogin(lC) 

ac: login accounting...ac(8) 

login: login new user.csh(l) 

get log: get user’s login name.. . . . . getlog(3F) 

getlogin: get login name. ..• . • • getlogin(3) 

login: login new user.csh(l) 

passwd: change login password.... passwd(l) 

/break, continue, cd, evaJ, exec, exit, export, login, read, readonly, set, shift, times, trap,/ • •*... sh(l) 

utmp, wtmp: login records. • • • utmp(S) 

rlogind: remote login server... rlogind(8C) 

chsh: change default login shell..... ..chsh(l) 

login: sign on. login(l) 

last: indicate last logins of users and teletypes. ••••••••••••• last(l) 

logout: end session..csh(l) 

setjmp, longjmp: non-local goto.. setjmp(3) 

look: find lines in a sorted list. .look(l) 

find references in a bibliography, indxbib, lookbib: build inverted index for a bibliography, • • • • lookbib(l) 

apropos: locate commands by keyword lookup. .apropos(l) 

finger: user information lookup program. . . . .finger(l) 

break: exit while/foreach loop. ...csh(l) 

continue: cycle in loop...csh(l) 

end: terminate loop. •••••.••••••••••••••••• csh(I) 

foreach: loop over list of names...csh(l) 

library, lorder: find ordering relation for an object ..••••• lorder(l) 

mklost+found: make a lost-ffound directory for fsck.. mklost+found(8) 

Ipc: line printer control program. .lpc(8) 

ipd: line printer daemon.. lpd(8) 

Ipq: spool queue examination program.. . lpq(l) 

Ipr: off line print...lpr(l) 

queue. Iprm: remove jobs from the line printer spooling • • • • lprm(l) 

is: list contents of directory...ls(l) 

Iseek: move read/write pointer.lseek(2) 

bit: and, or, xor, not, rshift, Ishift bitwise functions. ... . bit(3F) 

stat, Istat, fstat: get file status.. stat(2) 

stat, Istat, fstat: get file status.stat(3F) 

time, ctime, Itime, gmtime: return system time.. time(3F) 

Ixref: lisp cross reference program. .lxref(l) 

m4: macro processor. .m4(l) 

as: M68020 assembler. • . • • ..as(l) 

Standalone mode: definition of this Sanyo/ICON machine operation mode.. standalone(8) 

ruptime: show host status of local machines. ruptime(lC) 

rwho: who’s logged in on local machines.... rwho(lC) 

m4: macro processor.m4(l) 

alias: shell macros.csh(l) 

isprint, iscntrl, isascii: character classification macros, /isdigit, isalnum, isspace, ispunct, .ctype(3) 

ms: text formatting macros...ms(7) 

translate version 6 manual macros to version 7 macros, trman: .trman(l) 

me: macros for formatting papers. ... me(7) 

man: macros to typeset manual.man(7) 

trman: translate version 6 manual macros to version 7 macros. trman(l) 

tcopy: copy a mag tape...tcopy(l) 
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mt: magnetic tape manipulating program. • ..mt(l) 

rmt: remote magtape protocol module. • ••••••••••••• rmt(8C) 

mall: send and receive mail.....mail(l) 

encode/decode a binary file fen- transmission via mail. uuencode,uudecode:.. uuencode(lC) 

xsend, xget, enroll: secret mail. ...xsend(l) 

sendbug: mail a system bug report to 4bsd-bugs. . .sendbug(l) 

mailaddr: mail addressing description.maiiaddr(7) 

newaliases: rebuild the data base for the mail aliases file. ... newaliases(l) 

bin mail: send or receive mail among users. . binmail(l) 

biff: be notified if mail arrives and who it is from.biff(l) 

from: who is my mail from?.... from(l) 

prmail: print out mail in the post office. • .prmail(l) 

tmail: print out mail messages, most recent first.tmail(l) 

sendmail: send mail over the internet. « •.sendmail(8) 

msgs: system messages and junk mail program. . • ....msgs(l) 

rmail: handle remote mail received via uuep. ..rmaii(l) 

mail: send and receive mail.mail(l) 

mailaddr: mail addressing description. ..mailaddr(7) 

dmem, kmem: main memory.• • •.mem(4) 

make: maintain program groups.make(l) 

ar: archive and library maintainer. ..ar(l) 

intro: introduction to system maintenance and operation commands. • .intro(8) 

mkdir: make a directory.. ..mkdir(l) 

mkdir: make a directory file. . ....mkdir(2) 

link: make a hard link to a file.. link(2) 

link: make a link to an existing file. .iink(3F) 

mklost+found: make a lost+found directory for fsck.mklost+found(8) 

mknod: make a special file.mknod(2) 

mktemp: make a unique file name. • •.mktemp(3) 

In: make links.•.•.. ln(l) 

make: maintain program groups. • . ..make(l) 

symlink: make symbolic link to a file. • •••.••.••... symlink(2) 

makedev: make system special files...makedev(8) 

script: make typescript of terminal session.script(l) 

mkfs: program to make UNIX file systems. ...••••• .mkfs(S) 

makedev: make system special files.. makedev(8) 

makekey: generate encryption key.. makekey(8) 

allocator, malloc, free, realloc, calloc, alloca: memory.malloc(3) 

the manual, man: find manual information by keywords; print out . . man(I) 

man: macros to typeset manual. .man(7) 

shift: manipulate argument list. ....csb(I) 

quota: manipulate disk quotas. ... quota(2) 

route: manually manipulate the routing tables.. route(8C) 

mt: magnetic tape manipulating program. .mt(l) 

inetjnaof, inet_netof: Internet address manipulation routines. /inet_ntoa, inet__makeaddr, . . . inet(3n) 

frexp, Idexp, modf: split into mantissa and exponent. .. frexp(3) 

catman: create the cat files for the manual... ....catman(8) 

find manual information by keywords; print out the manual, man: ...man(l) 

man: macros to typeset manual. ... man(7) 

whereis: locate source, binary, and or manual for program. • • • • ..whereis(l) 

manual, man: find manual information by keywords; print out the .... man(l) 

trman: translate version 6 manual macros to version 7 macros.. trman(l) 

route: manually manipulate the routing tables..route(8C) 

umask: change or display file creation mask. •••••• csh(l) 

sigsetmask: set current signal mask. • sigsetmask(2) 

umask: set file creation mode mask. .. ••••• ...umask(2) 

mkstr: create an error message file by massaging C source.mkstr(l) 

intro: introduction to mathematical library functions.intro(3M) 

eqn, neqn, check eq: typeset mathematics.... eqn(l) 

getrlimit, setrlimit: control maximum system resource consumption.getriimit(2) 

vlimit: control maximum system resource consumption.viimit(3C) 

dis: an mc68020 disassembler...disfl) 

me: macros for formatting papers. ..me(7) 

bed: convert to antique media. •••••••••• bcd(6) 

groups: show group memberships.groups(l) 

dmem, kmem: main memory.mem(4) 

malloc, free, realloc, calloc, alloca: memory allocator.malloc(3) 

vailoc: aligned memory allocator.valloc(3) 

shmctl: shared memory control operations.shmctl(2) 

yfork: spawn new process in a virtual memory efficient way.. vfork(2) 

remove a message queue, semaphore set or shared memory id. iperm: ................. ipcrm(l) 

abort: terminate abruptly with memory image. ..abort(3F) 

core: format of memory image file...core(5) 

shmop: shared memory operations.shmop(2) 

shmget: get shared memory segment....shmget(2) 
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vmstat: report virtual memory statistics. . . . ..*.vmstat(l) 

merge: three-way file merge.. merge(l) 

sort: sort or merge files. . . ... . sort(l) 

resmerge: merge RCS revisions.. rcsmerge(l) 

merge: three-way file merge. • •.. . merge(l) 

pmerge: pascal file merger.pmerge(l) 

mesg: permit or deny messages. .. . . . mesg(l) 

msgeti: message control operations.msgctl(2) 

mkstr: create an error message file by massaging C source. ..mkstr(l) 

reev, recvfrom, recvmsg: receive a message from a socket.recv(2) 

send, send to, sendmsg: send a message from a socket.. . send(2) 

msgop: message operations. ... msgop(2) 

msgget: get message queue. • •••••••• .msgget(2) 

iperm: remove a message queue, semaphore set or shared memory id. • . • ipcrm(l) 

error: analyze and disperse compiler error messages. .. error(l) 

mesg: permit or deny messages.mesg(l) 

perror, sys_erriist, sys_nerr: system error messages...perror(3) 

perror, gerror, ierrno: get system error messages...•.. . . . perror(3F) 

psignal, sys_siglist: system signa] messages. . . . . ..psignal(3) 

syslog: log systems messages.syslog(8) 

msgs: system messages and junk mail program.msgs(l) 

rlog: print log messages and other information about RCS files.rlog(l) 

tmail: print out mail messages, most recent first. ... tmail(l) 

dmesg: collect system diagnostic messages to form error log. ..dmesg(8) 

mille: play Mille Bournes. .mille(6) 

mille: play Mille Bournes.... mille(6) 

intro: introduction to miscellaneous library functions. • • . ..intro(3X) 

pages, miscellaneous: miscellaneous useful information.intro(7) 

miscellaneous: miscellaneous useful information pages.intro(7) 

mkdir: make a directory.. mkdir(l) 

mkdir: make a directory file...mkdir(2) 

mkfs: program to make UNIX file systems.mkfs(8) 

mklost+found: make a lost+found directory for fsek. . • mklost+found(8) 

mknod: build special file. • • • •.. mknod(8) 

mknod: make a special file...mknod(2) 

mkproto: construct a prototype file system.. mkproto(8) 

source, mkstr: create an error message file by massaging C ... mkstr(l) 

mktemp: make a unique file name.mktemp(3) 

chmod: change mode.. chmod(l) 

getty: set terminal mode.getty(8) 

definition of this Sanyo/ICON machine operation mode.. Standalone mode: .standalone(8) 

operation mode.. Standalone mode: definition of this Sanyo/ICON machine .standalone(8) 

umask: set file creation mode mask. ... . . . . umask(2) 

chmod: change mode of a file. ...chmod(3F) 

chmod: change mode of file. .... chmod(2) 

frexp, ldexp, modf: split into mantissa and exponent. ..•••••• frexp(3) 

touch: update date last modified of a file. ... touch(l) 

recovery, eyacc: modified yacc allowing much improved error.. eyacc(l) 

rmt: remote magtape protocol module. ... rmt(8C) 

what: show what versions of object modules were used to construct a file. ..what(l) 

monitor, monstartup, moncontrol: prepare execution profile. ..monitor(3) 

profile, monitor, monstartup, moncontrol: prepare execution • • monitor(3) 

monop: Monopoly game. ... monop(6) 

monop: Monopoly game. ••••••• .. monop(6) 

monitor, monstartup, moncontrol: prepare execution profile. . . . monitor(3) 

more, page: file perusal filter for ert viewing.more(l) 

tmail: print out mail messages, most recent first.tmail(l) 

curses: screen functions with “optimal” cursor motion. ....curses(3X) 

mount, umount: mount and dismount file system. .mount(8) 

mount, umount: mount or remove file system. .. • • . • mount(2) 

mount, umount: mount and dismount file system. ... mount(8) 

mount, umount: mount or remove file system.mount(2) 

mtab: mounted file system table. • ..mtab(5) 

plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, dosepl:/ •••••• plot(3X) 

mv: move or rename files.mv(l) 

lseek: move read/write pointer. ..lseek(2) 

doscopyd: MPS/DOS file copy daemon. ••••••••••••• doscopyd(8) 

dosprint: MPS/DOS spooler daemon.. dosprint(8) 

program to create and display information for MPS/DOS v disks, dosdisk: ...dosdisk(8) 

dosdisks: list of MPS/DOS virtual disks. ... dosdisks(S) 

ms: text formatting macros.. ms(7) 

msgctl: message control operations.. msgctl(2) 

msgget: get message queue.msgget(2) 

msgop: message operations.msgop(2) 

msgs: system messages and junk mail program.msgs(l) 
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mt: magnetic tape manipulating program. mt(l) 

mtab: mounted file system table. ........... mtab(5) 

mttys: Multi-Link partition information. ..mttys(5) 

eyacc: modified yacc allowing much improved error recovery.. eyacc(l) 

mttys: Multi-Link partition information. ..mttys(5) 

bunt: a multi-player multi-terminal game. • ••••••••• hunt(6) 

select: synchronous i/o multiplexing. ....select(2) 

fsplit: split a multi-routine Fortran file into individual files.fsplit(l) 

hunt: a multi-player multi-terminal game. •••••••••••••••• hunt(6J 

switch: multi-way command branch. ..csh(l) 

mv: move or rename files. »...•• .mv(l) 

from: who is my mail from?. ••••••••••*•••••••• from(l) 

getdisk byname: get disk description by its name. .. getdisk(3X) 

getenv: value for environment name.getenv(3) 

getiog: get user’s login name. . . ♦ ♦.getlog(3F) 

getlogin: get login name. ..getlogin(3) 

getsockname: get socket name. .getsockname(2) 

mktemp: make a unique file name...mktemp(3) 

pwd: working directory name.... ... . pwd(l) 

tty: get terminal name. .. . .tty(l) 

hosts: host name data base. ... hosts(S) 

networks: network name data base. .networks(5) 

protocols: protocol name data base. ..protocois(5) 

services: service name data base. ... . . . . services(5) 

getpw: get name from uid. ..... • • • getpw(3C) 

nlist: get entries from name list. .. •••• .nlist(3) 

nm: print name list.nm(l) 

symorder: rearrange name list. ....symorder(l) 

rename: change the name of a file. . •••••• rename(2) 

ttyname, isatty, ttyslot: find name of a terminal. ..... ttyname(3) 

ttynam, isatty: find name of a terminal port...ttynam(3F) 

getpeername: get name of connected peer.getpeername(2) 

gethostname, sethostname: get/set name of current host. .. gethostname(2) 

hostnm: get name of current host...hostnm(3F) 

hostname: set or print name of current host system.. hostname(l) 

.PP dstrules: Daylight savings time and time zone name rule file.. ..... dstrules(5) 

bind: bind a name to a socket....bind(2) 

foreach: loop over list of names. .csh(l) 

term: conventional names for terminals. ••••••••••••••.. term(7) 

ncheck: generate names from i-numbers. .. ncheck(8) 

ncheck: generate names from i-numbers.ncheck(8) 

eqn, neqn, checkeq: typeset mathematics. ..eqn(l) 

netstat: show network status. .netstat(l) 

rdump: file system dump across the network. ....rdump(8C) 

rrestore: restore a file system dump across the network. ... rrestore(8C) 

ntohl, ntohs: convert values between host and network byte order, htonl, htons, .......... byteorder(3n) 

getnetbyname, setnetent, endnetent: get network entry, getnetent, getnetbyaddr, ....... getnetent(3n) 

gelhostbyname, sethostent, endhostent: get network host entry, gethostent, gethostbyaddr, • • • • gethostent(3n) 

ping: send ICMP ECHOJREQUEST packets to network hosts. .piDg(S) 

ifeonfig: configure network interface parameters. *••••••••••• ifconfig(8C) 

slattach: attach serial lines as network interfaces...slattach(8C) 

intro: introduction to network library functions. ••••• intro(3n) 

networks: network name data base. ..networks(5) 

routed: network routing daemon. ..routed(8C) 

netstat: show network status...netstat(l) 

networks: network name data base. .......... networks(S) 

creat: create a new file.creat(2) 

open a file for reading or writing, or create a new file, open:...open(2) 

newfs: construct a new file system.newfs(8) 

fork: create a new process...fork(2) 

vfork: spawn new process in a virtual memory efficient way.vfork(2) 

login: login new user...csh(l) 

adduser: procedure for adding new users...adduser(8) 

aliases file, newaliases: rebuild the data base for the mail . • • • • newaliases(l) 
newfs: construct a new file system. •••••••••• newfs(8) 

dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines. ..dbm(3X) 

gettable: get NIC format host tables from a host.. gettable(8C) 

htable: convert NIC standard format host tables.htabie(8) 

▼grind: grind nice listings of programs...vgrind(l) 

(*h only), nice, nohup: run a command at low priority .nice(l) 

nice: run low priority process.csh(l) 

nice: set program priority...nice(3C) 

nlist: get entries from name list.n)ist(3) 

nm: print name list.. nm(l) 

only), nice, nohup: run a command at low priority (sh .nice(l) 
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Permuted Index 


setjmp, longjmp: 
bit: and, or, xor, 
notify: request immediate 
biff: be 

soelim: eliminate .so 1 * from 
tbl: format tables for 
eolert: filter 

troff, 
deroff: remove 
checknr: check 
network byte order, htonl, htons, 
order, htonl, htons, ntohl, 


phones: remote host phone 
arithmetic: provide drill in 
rand, srand: random 
random, srandom, initstate, setstate: better random 

vers: print version 
atof, atoi, atol: convert ASCII to 
intro: introduction to system calls and error 
number: convert Arabic 
idate, itime: return date or time in 
loc: return the address of an 
long, short: integer 
size: size of an 
lorder: find ordering relation for an 
what: show what versions of 
strings: find the printable strings in a 
index, rindex, lnblnk, len: tell about character 

od: 

prmail: print out mail in the post 

nohup: run a command at low priority (sh 
program file including aliases and paths (esh 

file, open: 
fopen, freopen, fdopen: 
flock: apply or remove an advisory lock on an 

a new file, 
dosedir: directory operations, 
closedir: directory operations, directory: 

syslog, 

cont, point, linemod, space, closepl:/ plot: 

kgmon: generate a dump of the 
intro: introduction to system maintenance and 
mode: definition of this Sanyo/ICON machine 
tgetstr, tgoto, tputs: terminal independent 
bcopy, bemp, bzero, fls: bit and byte string 
telldir, seekdir, rewinddir, closedir: directory 
telldir, seekdir, rewinddir, closedir: directory 
msgctl: message control 
msgop: message 
semctl: semaphore control 
semop: semaphore 
shmctl: shared memory control 
shmop: shared memory 
strepy, strnepy, strlen, index, rindex: string 
join: relational database 
curses: screen functions with 
fcntl: file control 
stty: set terminal 
getsockopt, setsockopt: get and set 
stohs: convert values between host and network byte 
lastcomm: show last commands executed in reverse 
tac: concatenate and print files in reverse 
lorder: find 

bessel functions: of two kinds for integer 

vi: screen 

a.out: assembler and link editor 
terminate a process after flushing any pending 

ecYt, fevt, gcYt: 


nohup: run command immune to hangups.. . 

non-local goto.. . .. 

not, rshift, lshift bitwise functions. .»•••••»•• 

notification.... . . . . 

notified if mail arrives and who it is from. 

notify: request immediate notification. 

nroff input.. . .... 

nroff or troff... 

nroff output for CRT previewing.. 

nroff: text formatting. • 

nroff: text formatting and typesetting. 

nroff, troff, tbl and eqn constructs.. . . . . 

nroff/troff files... 

ntohl, ntohs: convert values between host and • • . . • 
ntohs: convert values between host and network byte • • 

null: data sink... 

number: convert Arabic numerals to English. 

number data base. 

number facts. 

number generator.. . . • 

number generator; routines for changing generators. • . 

number of the kernel.. 

numbers... 

numbers. ... . .. 

numerals to English.. • • • 

numerical form.. 

object. ..... 

object conversion. • ••••••••• . 

object file. .... 

object library. .. 

object modules were used to construct a file. • •*••• 

object, or other binary, file. .. 

objects. .. 

octal, decimal, hex, ascii dump. 

od: octal, decimal, hex, ascii dump. * ... 

office.•. 

onintr: process interrupts in command scripts. 

only), nice, .. . . . .. 

only), which: locate a.. .. 

open a file for reading or writing, or create a new . • . . 

open a stream. ... 

open file. ...••• . 

open: open a file for reading or writing, or create • • • • 
opendir, readdir, telldir, seekdir, rewinddir, »••••• 

opendir, readdir, telldir, seekdir, rewinddir, .. 

openlog, closelog: control system log.. . . • 

openpl, erase, label, line, circle, arc, move, • •••••• 

operating system’s profile buffers. .. 

operation commands. ... . . . . 

operation mode.. Standalone • •••••• . 

operation routines, tgetent, tgetnum, tgetflag, . 

operations.. 

operations, opendir, readdir, • 

operations, directory: opendir, readdir, • 

operations. 

operations. . 

operations. .. 

operations. .. 

operations. .... . . . 

operations.... 

operations, streat, strncat, stremp, strnemp, •••••• 

operator. .. 

“optimal” cursor motion. 

options. ..... 

options. .. 

options on sockets. ... . 

order, htonl, htons, ntohl.. 

order... 

order...... 

ordering relation for an object library.. . 

orders... 

oriented (visual) display editor based on ex. 

output. ... 

output, exit: . 

output conversion... 


«h(l) 

setjmp(3) 

bit(3F) 

csh(l) 

biff(I) 

csh(l) 

soelim(l) 

tbl(l) 

eolcrt(l) 

nroff(l) 

troff(l) 

deroff(l) 

checknr(l) 

byteorder(3n) 

byteorder(3n) 

null(4) 

number(6) 

phones(S) 

arithmetics) 

rand(3C) 

random(3) 

vers(l) 

atof(3) 

intro(2) 

number(6) 

idate(3F) 

Joc(3F) 

long(3F) 

size(I) 

lorder(l) 

what(l) 

strings(l) 

index(3F) 

od(l) 

od(l) 

prmail(l) 

csh(l) 

nice(l) 

which(l) 

open(2) 

fopen(3S) 

flock (2) 

open(2) 

directory(3) 

directory (3X) 

syslog(3) 

plot(3X) 

kgmon (8) 

intro(8) 

stand alone(8) 

termcap(3X) 

bstring(3) 

directory (3) 

directory (3X) 

msgctl(2) 

msgop(2) 

semctl(2) 

semop(2) 

shmctl(2) 

shmop(2) 

string(3) 

join(l) 

curses(3X) 

fcntl(5) 

»tty(l) 

getsockopt(2) 

byteorder(3n) 

lastcomm(l) 

tac(l) 

lorder(l) 

bessel(3F) 

vi(l) 

a.out(5) 

exit(3) 

ecvt(3) 


ICON INTERNATIONAL 


xli 










































































Permuted Index 


printf, fprintf, sprintf: formatted 
fold: fold long lines for finite width 
colcrt; filter nroff 
dosprinters: destinations for spooled 
flush: flush 
foreach: loop 
sendm&il: send mail 
trapov: trap and repair floating point 

exec: 

chown: change 
chown: change 
quot: summarize file system 

ping: send ICMP ECHCUtEQUEST 

more, 

getpagesize: get system 
pagesize: print system 
miscellaneous: miscellaneous useful information 

tk: 

swapon: specify additional device for 
socketpair: create a 
me: macros for formatting 
ifeonfig: configure network interface 

park: program to 
mttys: Multi-Link 
pc: 
pxref: 
pdx: 
pxp: 
p merge: 
px: 
pix: 
Pi: 


getpass: read a 
passwd: change login 
passwd: 
vipw: edit the 

getpwuid, getpwnam, setpwent, endpwent: get 
getwd: get current working directory 
getewd: get 

which: locate a program file including aliases and 
grep, egrep, fgrep: search a file for a 

awk: 


popen, 

getpeername: get name of connected 
exit: terminate a process after flushing any 

mesg: 

ptx: 

, limit: alter 

messages, 
sticky: executable files with 
more, page: file 
phones: remote host 

pti: 

tc: 

hosts. 

tee: 

*>g: 

fish: 

mille: 

boggle: 

worm: 


output conversion. . . ... • • 

output device.. • . * .. 

output for CRT previewing... 

output from SLPT printers. ... . 

output to a logical unit.• • •. 

oyer list of names.. • • ..• • • • 

over the internet.... • • . 

overflow.. ... 

overlay shell with specified command. •. 

owner. * . . .... 

owner and group of a file. . . . ... . . . . 

ownership.. 

pac: printer/plotter accounting information.. . 

packets to network hosts... 

page: file perusal filter for ert viewing. • •••••••• 

page size. ...... 

page size. 

. 

pagesize: print system page size.. • 

paginator for the Tektronix 4014. • •.••••••• 

paging and swapping. .. . . . 

pair of connected sockets. • • • . •.. . . . 

papers.. . 

parameters... 

park: program to park the hard disk heads. • ••••• 

park the hard disk heads... 

partition information. • ••••••••••••••• 

Pascal compiler.. 

Pascal cross-reference program. • •••.•• . 

pascal debugger. • • •.• •. 

Pascal execution profiler.. 

pascal file merger.... 

Pascal interpreter. • •.. 

Pascal interpreter and executor. 

Pascal interpreter code translator. 

passwd: change login password... 

passwd: password file... 

password. 

password. ..... . . . . 

password file...• 

password file. .. 

password file entry, getpwent,.. . . . . 

pathname.... 

pathname of current working directory. • ••••••• 

paths (c*h only).. 

pattern. .. 

pattern scanning and processing language. ....... 

pause: stop until signal... 

pc: Pascal compiler.. . . . .. 

pclose: initiate I/O to/from a process. 

pdx: pascal debugger. .. 

peer. .... 

pending output... 

permit or deny messages. .. 

permuted index. .. 

per-process resource limitations. .. 

perror, gerror, ierrno: get system error messages. 

perror, sys_errlist, sys_nerr: system error 

persistent text...... 

perusal filter for ert viewing. ... 

phone number data base.. 

phones: remote host phone number data base. • . • • • 

phototypesetter interpreter. ... . . . . 

photoypesetter simulator.. • • • . 

pi: Pascal interpreter code translator. 

ping: send ICMP ECHOJtEQUEST packets to network . 
pipe: create an interprocess communication channel. • • • 

pipe fitting. •••«•• ... 

pix: Pascal interpreter and executor.. • • . 

place job in background. ••••• 

play “Go Fish”. 

play Mille Bournes.. 

play the game of boggle. 

Play the growing worm game. • • • .. 

plot: graphics filters... 


printf(3S) 

fold(l) 

cdcrt(I) 

dosprinters(5) 

flush (3F) 

csh(l) 

sendmail(8) 

trapov(3F) 

csh(l) 

chown(8) 

chown(2) 

quot(8) 

P*c(8) 

ping(8) 

more(l) 

getpagesize(2) 

pagesize(l) 

intro(7) 

pagesize(l) 

tk(i) 

swapon(8) 

socketpair(2) 

nw(7) 

ifconfig(8C) 

park(8) 

park(8) 

mttys(5) 

pc(l) 

pxr«f(l) 

pdxfJ) 

pxp(l) 

pmerge(l) 

PX(1) 

pix(l) 

P>(1) 

passwd(l) 

passwd(5) 

getpass(d) 

passwd(l) 

passwd(5) 

vipw(8) 

getpwent(3) 

getwd(3) 

getcwd(3F) 

which(l) 

gr«p(l) 

awk(l) 

pause(3C) 

pc(l) 

popen(3) 

pdx(l) 

getpeername(2) 

exit(3) 

mesg(l) 

ptx(l) 

csh(l) 

perror(3F) 

perror(3) 

sticky(8) 

more(l) 

phones(5) 

phones(5) 

pti(l) 

aii 

ping(8) 

pipe(2) 

M 1 ) 

pix(l) 

csh(l) 

fish(6) 

mille(6) 

boggle(6) 

worm(6) 

plot(lG) 
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Permuted Index 



plot: graphics interface. • •.. . . plot(5) 

move, cont, point, linemod, space, elosepl:/ plot: openpl, erase, label, line, circle, arc, • •....•• plot(3X) 

pmerge: pascal file merger..pmerge(l) 

fpti: determine presence of the floating point coprocessor. ...••••• .fpu(l) 

trpfpe, fpeent: trap and repair floating point faults...trpfpe(3F) 

/erase, label, line, circle, arc, move, cont, point, linemod, space, elosepl: graphics interface.plot(3X) 

trapov: trap and repair floating point overflow.. trapov(3F) 

Iseek: move read/write pointer.lseek(2) 

popd: pop shell directory stack. ..csh(l) 

popd: pop shell directory stack. «•••••••••. csh(l) 

popen, pdose: initiate I/O to/from a process.popen(3) 

ttynam, isatty: find name of a terminal port.ttynam(3F) 

tty type: data base of terminal types by port.ttytype(S) 

prmail: print out mail in the post office.prmail(l) 

root, exp, log, loglO, pow, sqrt: exponential, logarithm, power, square • • • . exp(3M) 

exp, log, loglO, pow, sqrt: exponential, logarithm, power, square root.•.exp(3M) 

name rule file.. . PP dstrules: Daylight savings time and time zone • • • • dstrules(5) 

pr: print file. • • •.. . . pr(l) 

print: pr to the printer. • ••••••• .print(l) 

prec: C precedence chart.prec(7) 

prec: C precedence chart.prec(7) 

monitor, monstartup, moncontrol: prepare execution profile...monitor(3) 

fpu: determine presence of the floating point coprocessor.fpu(l) 

colcrt: filter nroff output for CRT previewing.•.colcrt(l) 

types: primitive system data types.types(5) 

cat: catenate and print...cat(l) 

Ipr: off line print. • •.. lpr(l) 

fortune: print a random, hopefully interesting, adage.fortune(6) 

date: print and set the date. • • . •.date(l) 

cal: print calendar. ... cal(l) 

hashstat: print command hashing statistics. • ••.•••••• csh(l) 

jobs: print current job list. • ••••••• .csh(l) 

whoami: print effective current user id. .whoami(l) 

pr: print file. . • . ... pr(l) 

tac: concatenate and print files in reverse order. .. . . . . tac(l) 

fpr: print Fortran file.fpr(l) 

history: print history event list...csh(l) 

hostid: set or print identifier of current host system. ...••••• hostid(l) 

banner: print large banner on printer.• •••••• banner(6) 

files, rlog: print log messages and other information about RCS . . rlog(l) 

nm: print name list. ..nm(l) 

hostname: set or print name of current host system.hostname(l) 

prmail: print out mail in the post office.• • • • prmail(l) 

tmail: print out mail messages, most recent first. • tmail(l) 

printenv: print out the environment. ..printenv(l) 

man: find manual information by keywords; print out the manual.. . . . . man(l) 

print: pr to the printer. .. print(l) 

pstat: print system facts.... pstat(8) 

pagesize: print system page size. .. . pagesize(l) 

vers: print version number of the kernel. ..vers(l) 

diction,explain: print wordy sentences; thesaurus for diction. ...... diction(l) 

explain, diction- print wordy sentences; thesaurus for diction. ...... explain(l) 

file, strings: find the printable strings in a object, or other binary, •••••. strings(l) 

printcap: printer capability data base... . printcap(b) 

printenv: print out the environment.printenv(l) 

banner: print large banner on printer.... banner(6) 

print: pr to the printer. ... . • ... print(l) 

printcap: printer capability data base. ... printcap(S) 

ipc: line printer control program. . ... lpc(8) 

Ipd: line printer daemon. • • • • lpd(8) 

deanlpd: clean line printer daemon environment. deanlpd(8) 

Iprm: remove jobs from the line printer spooling queue. . lprm(l) 

pac: printer/plotter accounting information.pac(8) 

destinations for spooled output from SLPT printers, dosprinters: ... dosprinters(S) 

conversion, printf, fprintf, sprintf: formatted output . • printf(3S) 

setpriority: get/set program scheduling priority, getpriority, .getpriority(2) 

nice: set program priority. •••• nice(3C) 

nice, nohup: run a command at low priority (*A only)...nice(l) 

renice: alter priority of running processes. ••••. renice(8) 

nice: run low priority process. • ..csh(l) 

prmail: print out mail in the post office.prmail(l) 

dose: connect to proc/286 system.dosc(l) 

add user: procedure for adding new users. • • • ..adduser(8) 

reboot: UNDC bootstrapping procedures.. reboot(8) 

nice: run low priority process.csh(l) 
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Permuted Index 


stop: halt a job or 
_exit: terminate a 
fork: create a new 
fork: create a copy of this 
implogd: IMP logger 
kill: send signal to a 
kill: send a signal to a 
popen, pclo6e: initiate I/O to/from a 
wait: await completion of 
exit: terminate a 
init: 

getpgrp: get 
killpg: send signal to a 
setpgrp: set 
getpid: get 
getpid,getppid:£et 
▼fork: spawn new 
onintr: 
ps: 

times: get 
wait, wait3: wait for 
wait: wait for a 
ptrace: 
kill: terminate a 
exit: terminate 
kill: kill jobs and 
gcore: get core images of running 
renice: alter priority of running 
wait: wait for background 
awk: pattern scanning and 
halt: stop the 
u*4: macro 
reboot: reboot system or halt 


monitor, monstartup, moncontrol: prepare execution 

profil: execution time 
kgmon: generate a dump of the operating system’s 
gprof: display call graph 
prof: display 
pxp: Pascal execution 
copy: standalone copy 
end, etext, edata: last locations in 
finger: user information lookup 
ftp: file transfer 
liszt: compile a Franz Lisp 
Ipc: line printer control 
Ipq: spool queue examination 
lxref: lisp cross reference 
msgs: system messages and junk mail 
mt: magnetic tape manipulating 
pxref: Pascal cross-reference 
rdist: remote file distribution 
tftp: trivial file transfer 
units: conversion 
whereis: locate source, binary, and or manual for 

cb; C 

only), which: locate a 
make: maintain 
nice: set 

getpriority, set priority: get /set 
indent: indent and format C 
MPS/DOS vdisks. dosdisk: 

binstl: 
blond: 
mkfs: 
park: 
assert: 
lint: a C 
fp: Functional 
bload: program to load standalone 
lex: generator of lexical analysis 
struct: structure Fortran 
vgrind: grind nice listings of 
xstr: extract strings from C 


process... 

process. . . . . ... . . . 

process.. 

process. • .. 

process. 

process... 

process. . . . ... 

process. . ... 

process... 

process after flushing any pending output. • 

process control initialization. • 

process group. ••••••••••••. 

process group.. 

process group.. . . .. 

process id. 

process identification. •««••••••• 

process in a virtual memory efficient way. 
process interrupts in command scripts. . . 

process status.. . . . . 

process times... 

process to terminate. 

process to terminate. 

process trace.. . . . . 

process with extreme prejudice. ...... 

process with status. • •••••»•••• 

processes... 

processes.. 

processes. .. . . . . 

processes to complete.. • 

processing language. . . . • .. 

processor. .... 

processor.. • . 

processor. ....... .. 

prof: display profile data. . 

profil: execution time profile. ••••••• 

profile... 

profile. ... 

profile buffers.. 

profile data. 

profile data. .. 

profiler. • • .. 

program. ... 

program. .. 

program. ............... 

program. • • • •. 

program. 

program. 

program.. 

program.. 

program.. 

program.. 

program. . .. 

program.• •. 

program. 

program. ... . . 

program. • 

program beautifier. 

program file including aliases and paths (cth 

program groups. 

program priority. 

program scheduling priority.. 

program source. 

program to create and display information for 
program to install bootloader on disk. • . • 
program to load standalone programs. • • 
program to make UNIX file systems. . . . 
program to park the hard disk heads. • • • 

program verification. 

program verifier. ............ 

Programming language compiler/interpreter. 

programs. • . . .. 

programs... 

programs.. 

programs. 

programs to implement shared strings. • . 


csh(l) 

exit (2) 

fork(2) 

fork(3F) 

implogd(8C) 

kill(2) 

kill(3F) 

popen(3) 

wait(l) 

exit(3) 

init(8) 

getpgrp(2) 

kiUpg(2) 

•etpgrp(2) 

getpid(3F) 

getpid(2) 

rfork(2) 

csh(l) 

p*(l) 

times(3C) 

wait(2) 

wait(3F) 

ptrace(2) 

kill(l) 

exit(3F) 

eeh(l) 

gcore(l) 

renice(8) 

csh(l) 

awk(l) 

balt(8) 

m4(l) 

reboot(2) 

prof(l) 

profil(2) 

mooitor(3) 

proftl(2) 

kgmon(8) 

gprof(l) 

pror(l) 

Pxp(l) 
copy(8) 

end(3) 

finger(l) 

ftp(lC) 

liszt(l) 

lpc(8) 

ipq(i) 

lxrer(l) 

msgs(l) 

mt(l) 

pxref(l) 

rdist(l) 

tftp(lC) 

units(l) 

whtreis(l) 

cb(l) 

which(l) 

make(l) 

nice(3C) 

getpriority (2) 

indent(I) 

dosdisk (8) 

binstl(8) 

bload(8) 

mkfs(8) 

park(8) 

assert(3X) 

lint(l) 

fp(l) 

bload (8) 

lexm 

struct(l) 

Ygrind(l) 

xstr(l) 
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telnet: user interface to the TELNET protocol. .telnet(lC) 

get protobyname, setprotoent, endprotoent: get protocol entry, getprotoent, getprotoby number, . • . . getprotoent(3n) 

rmt: remote magtape protocol module.rmt(8C) 

protocols: protocol name data base. ... protocols(5) 

ftpd: DARPA Internet File Transfer Protocol server.ftpd(8C) 

telneld: DARPA TELNET protocol server.... . telnetd(8C) 

tftpd: DARPA Trivial File Transfer Protocol server.tftpd(8C) 

trpt: transliterate protocol trace. ... trpt(8C) 

protocols: protocol name data base.protocols(S) 

mk proto: construct a prototype Hie system. ... mkproto(8) 

arithmetic: provide drill in number facts. ..arithmetic(6) 

false, true: provide truth values. ..false(l) 

true, false: provide truth values. ...true(l) 

ps: process status. .ps(l) 

psignal, sys«*iglist: system signal messages.• • psignal(3) 

pstat: print system facts.pstat(8) 

doctor: interact with a psychoanalyst. ...... .doctor(6) 

pti: phototypesetter interpreter.pti(l) 

ptrace: process trace. • •••••• .ptrace(2) 

ptx: permuted index.ptx(l) 

ungetc: push character back into input stream. . .ungetc(3S) 

pushd: push shell directory stack.. csh(l) 

pushd: push shell directory stack.. csh(l) 

puts, fputs: put a string on a stream.puts(3S) 

putc, putchar, fputc, putw: put character or word on a stream.. putc(3S) 

unit, putc, fputc: write a character to a fortran logical • • • • putc(3F) 
on a stream, putc, putchar, fputc, putw: put character or word . • • putc(3S) 
stream, putc, putchar, fputc, putw: put character or word on a • . . • putc(3S) 

puts, fputs: put a string on a stream.. • puts(3S) 

putc, putchar, fputc, putw: put character or word on a stream. . ..putc(3S) 

pwd: working directory name. .pwd(l) 

px: Pascal interpreter. • ••••••.. .px(l) 

pxp: Pascal execution profiler...pxp(l) 

pxref: Pascal cross-reference program. ••••••••• pxref(l) 

qsort: quick sort. ..... qsort(3F) 

qsort: quicker sort.qsort(3) 

insque, remque: insert/remove element from a queue. insque(3) 

Iprm: remove jobs from the line printer spooling queue...iprm(l) 

msgget: get message queue.. msgget(2) 

lpq: spool queue examination program. ..Ipq(X) 

iperm: remove a message queue, semaphore set or shared memory id.ipcrm(l) 

qsort: quick sort. ..qsort(3F) 

qsort: quicker sort.. qsort(3) 

quiz: test your knowledge...quiz(6) 

quot: summarize file system ownership.. quot(8) 

quotacheck: file system quota consistency checker. ....quotacheck(8) 

quota: display disc usage and limits. ...••.••• quota(l) 

quota: manipulate disk quotas... quota(2) 

quotacheck: file system quota consistency checker. . . . quotacheck(8) 
quotaon, quotaoff: turn file system quotas on and off. ...... quotaon(8) 

off. quotaon, quotaoff: turn file system quotas on and .... quotaon(8) 

edquota: edit user quotas.... edquota|8) 

quota: manipulate disk quotas...quota(2) 

repquota: summarize quotas for a file system. ...repquota(8) 

setquota: enable/disable quotas on a file system. .. setquota(2) 

quotaon, quotaoff: turn file system quotas on and off. . quotaon(8) 

rain: animated raindrops display.. • • • rain(6) 

rain: animated raindrops display. ..rain(6) 

rand, drand, irand: return random values.rand(3F) 

rand, srand: random number generator. ••••••.. rand(3C) 

fortune: print a random, hopefully interesting, adage.fortune(6) 

ranlib: convert archives to random libraries. ..ranlib(l) 

rand, srand: random number generator.rand(3C) 

random, arandom, initstate, aetstate: better random number generator; routines for changing/ • • . random(3) 
number generator; routines for changing/ random, srandom, initstate, setstate: better random • • random(3) 

rand, drand, irand: return random values..... rand(3F) 

ranlib: convert archives to random libraries.ranlib(l) 

rat for: rational Fortran dialect.ratfor(l) 

ratfor: rational Fortran dialect. ..••••• .ratfor(l) 

rc: command script for auto-reboot and daemons. • • . rc(8) 
stream to a remote command, remd, rresvport, ruserok: routines for returning a .... rcmd(3X) 

rep: remote file copy.. rcp(lC) 

res: change RCS file attributes.rcs(l) 

rcsintro: introduction to RCS commands.. rcsintro(l) 

resfile: format of RCS file...rcsfile(5) 
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res: change RCS file attributes.... rcs(l) 

sccstorcs: build RCS file from SCCS file. ..sccstorcs(l) 

Bccstorcs: build RCS file from SCCS file.. . . . sccstorcs(8) 

print log messages and other information about RCS files, riog: ..rlog(l) 

ci: check in RCS revisions. ... . ... ci(l) 

co: check out RCS revisions.co(l) 

resdiff: compare RCS revisions...rcsdiff(l) 

resmerge: merge RCS revisions....rcsmerge(l) 

resdiff: compare RCS revisions...rcsdiff(l) 

resfile: format of RCS file... ..rcsfile(S) 

resintro: introduction to RCS commands. ..rcsintro(l) 

resmerge: merge RCS revisions. • ••••••••••• rcsmerge(l) 

rdist: remote file distribution program.. • rdist(l) 

rdump: file system dump across the network. • . • . • rdump(8C) 

getpass: read a password. ..getpass(3) 

source: read commands from file...csh(l) 

read, readv: read input. ...... .read (2) 

/continue, cd, evai, exec, exit, export, login, read, readonly, set, shift, times, trap, umask,/ . . . . . sh(l) 

read, readv: read input. .•••«••••• .read(2) 

readlink: read value of a symbolic link. • •.. readlink(2) 

directory operations, opendir, readdir, telidir, seekdir, rewinddir, closedir: ...... directory (3) 

directory operations, directory: opendir, readdir, telidir, seekdir, rewinddir, closedir: directory(3X) 

open: open a file for reading or writing, or create a new file. . ... open(2) 

readlink: read value of a symbolic link. ..•••••• readlink(2) 

command/ /cd, eval, exec, exit, export, login, read, readonly, set, shift, times, trap, umask, wait: . sh(l) 

read, readv: read input.. . . . . read(2) 

Iseek: move read/write pointer. *...••••••••••••• lseek(2) 

setregid: set real and effective group ID.setregid(2) 

setreuid: set real and effective user ID's. ..setreuid(2) 

malloc, free, realloc, calloc, alioca: memory allocator.malloc(3) 

symorder: rearrange name list. • ••••• .. symorder(l) 

reboot: reboot system or halt processor.reboot(2) 

reboot: reboot system or halt processor. .•••.•••••• reboot(2) 

reboot: UNIX bootstrapping procedures.. reboot(8) 

fastboot, fasthalt: reboot/halt the system without checking the disks. • . • fastboot(8) 
newaliases: rebuild the data base for the mail aliases file. •••••• newaJiases(l) 

recY, recYfrom, recvmsg: receive a message from a socket. •••*.•••••• recv(2) 

mail: send and receive mail. ... mail(l) 

binmail: send or receive mail among users.. . . . . binmail(l) 

rmail: handle remote mail received via uuep. ....rmail(l) 

tmail: print out mail messages, most recent first.. tmail(I) 

re„comp, re_exec: regular expression handler. •••••• regex(3) 

rehash: recompute command hash table.. csh(l) 

lockf: record locking on files. .... lockf(3C) 

utmp, wtmp: login records.. utmp(5) 

joye.jrecover - recover JOVE buffers after a system/editor crash. • . • jovejrecoYer(l) 

eyacc: modified yacc allowing much improved error recovery.eyacc(l) 

socket, reev, recvfrom, recvmsg: receive a message from a . . . . recv(2) 
recY, recvfrom, recvmsg: receive a message from a socket. • . • recv(2) 
reev, recvfrom, recvmsg: receive a message from a socket. ••••••• recv(2) 

eval: re-evaluate shell data.. ..csh(l) 

re„comp, re^exec: regular expression handler. ••.••••••• regex(3) 

documents, refer: find and insert literature references in ...... refer(l) 

lxref: lisp cross reference program.. lxref(l) 

build inverted index for a bibliography, find references in a bibliography, indxbib, looklib: ..... lookbib(l) 

refer: find and insert literature references in documents. ••••.•••• refer(l) 

re_eomp, re_exec: regular expression handler. •••• regex(3) 

rehash: recompute command hash table.csh(l) 

comm: select or reject lines common to two sorted files.comm(l) 

lorder: find ordering relation for an object library.iorder(l) 

join: relational database operator.join(l) 

sigpause: atomically release blocked signals and wait for interrupt.sigpause(2) 

strip: remove symbols and relocation bits. • ..strip(l) 

leave: remind you when you have to leave. •••.••••• leave(l) 

calendar: reminder service. ....calendar(l) 

ruserok: routines for returning a stream to a remote command, remd, rresvport,.. rcmd(3X) 

rexec: return stream to a remote command. ••••.•••••••• rexec(3X) 

rexecd: remote execution server. rexecd(8C) 

rep: remote file copy.rcp(lC) 

rdist: remote file distribution program. .. • • • • rdist(l) 

uusend: send a file to a remote host.....uusend(lC) 

remote: remote host description file.remote(5) 

phones: remote host phone number data base.phones(5) 

rlogin: remote login.. ••••. rlogin(lC) 

rlogind: remote login server. ..rlogind(8C) 
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rmt: 

rmail: handle 

rsh: 

rshd: 

tip, cu: connect to & 
Ulkd: 
unlink: 
rmdir: 

memory id. iperm: 

nn alias: 
flock: apply or 
eolrm: 
unlink: 
unsetenv: 
mount, umount: mount or 
unifdef: 
Iprm: 
deroff: 
unlimit: 
strip: 
rmdir, rm: 
rm, rmdir: 
insque, 
rename: 

my: move or 


fsck: file system consistency check and interactive 
trpfpe, fpeent: trap and 
trapov: trap and 
while: 

uniq: report 
repeat: execute command 
yes: be 
status, ipcs: 
iostat: 
uniq: 

sendbug: mail a system bug 
vmstat: 
bugfiler: file bug 
fseek, ftell: 
fseek, ftell, rewind: 

notify: 

lock: 

reset: 

getrlirnit, setrlimit: control maximum system 
vlimit: control maximum system 
limit: alter per-process 
unlimit: remove 
getrusage: get information about 
▼times: get information about 
restore: incremental file system 
rrestore: 

suspend: suspend a shell, 
getarg, iarge: 

fdate: 
idate, itime: 
etime, dtime: 

flmin, fimax, ffrac, dfimin, dflmax, dffrac, inmax: 

rand, drand, irand: 

rexec: 

time, etime, Itime, gmtime: 

loc: 

remd, rresvport, ruserok: routines for 

col: filter 
rev: 

lastcomm: show last commands executed in 
tac: concatenate and print files in 


remote magtape protocol module. • •••••••••• 

remote mail received via uucp. 

remote: remote host description file. • • • *.. 

remote shell. .. .......... 

remote shell server. .... 

remote system. • • •.•. 

remote user communication server. • ••••••••• 

remove a directory entry... 

remove a directory file... 

remove a message queue, semaphore set or shared • . . • 

remove aliases. .. 

remove an advisory lock on an open file. • ••••••• 

remove columns from a file. • . 

remove directory entry.. . . . 

remove environment variables. • • •. 

remove file system. 

remove ifdefed lines.. 

remove jobs from the line printer spooling queue. • • • • 

remove nroff, troll, tbl and eqn constructs.. 

remove resource limitations.. . . . . 

remove symbols and relocation bits.. • • • • 

remove (unlink) directories or files. ... 

remove (unlink) files or directories. •••••••••• 

remque: insert/remove element from a queue. • • • • • 

rename a file.. . . . . 

rename: change the name of a file. • • • .. 

rename files.. 

rename: rename a file.. .. 

renice: alter priority of running processes. 
repair.. 

repair floating point faults.. 

repair floating point overflow.• • • • 

repeat commands conditionally. 

repeat: execute command repeatedly. . 

repeated lines in a file. .. . . . 

repeatedly. 

repetitively affirmative. . 

report inter-process communication facilities .. 

report I/O statistics. . 

report repeated lines in a file. . 

report to 4bsd-bugs. . 

report virtual memory statistics. • . • .. 

reports in folders automatically. .. . . . . 

reposition a file on a logical unit... 

reposition a stream. • ••.•• . . . . . 

repquota: summarize quotas for a file system. 

request immediate notification. • • •. 

reserve a terminal. .. 

reset: reset the teletype bits to a sensible state. • . • • • 

reset the teletype bits to a sensible state. 

resource consumption.... . 

resource consumption. ....... .. 

resource limitations. .. 

resource iimitiations.. • 

resource utilization... 

resource utilization. 

restore... 

restore a file system dump across the network. 

restore: incremental file system restore. 

resuming its superior.. • • 

return command line arguments. •••• . 

return date and time in an ASCII string. 

return date or time in numerical form. 

return elapsed execution time. 

return extreme values. 

return random values.. 

return stream to a remote command. 

return system time. •••••• 

return the address of an object. •••••• . 

returning a stream to a remote command. .. 

rev: reverse lines of a file.. 

reverse line feeds.. 

reverse lines of a file. ••••••• 

reverse order. 

reverse order. .... 


rmt(8C) 

rmail(l) 

remote(5) 

rsh(lC) 

rshd(8C) 

tip(lC) 

talkd(8C) 

unlink(3F) 

rmdir(2) 

ipcrm(l) 

csh(l) 

flock (2) 

colrm(l) 

unlink(2) 

esh(l) 

mount(2) 

unifdefi(l) 

lprm(l) 

deroff(l) 

csh(l) 

strip(l) 

rmdir(l) 

rm(l) 

insque(3) 

rename(3F) 

rename(2) 

mv(l) 

rename(3F) 

renice(8) 

fsck (8) 

trpfpe(3F) 

trapov(3F) 

csh(l) 

csh(l) 

uniq(l) 

csh(l) 

y«s(i) 

ipcs(I) 

iostat(l) 

uniq(l) 

sendbug(l) 

vmstat(X) 

bugfiler(8) 

fseek(3F) 

fseek(3S) 

repquota(8) 

csh(l) 

lock(l) 

reset(l) 

reset(l) 

getrlimit(2) 

vlimit(3C) 

csh(l) 

csh(l) 

getrusage(2) 

vtimes(3C) 

restore(8) 

rrestore(8C) 

restore(8) 

csh(l) 

getarg(3F) 

fdate(3F) 

idate(3F) 

etime(3F) 

flmin(3F) 

rand(3F) 

rexec(3X) 

time(3F) 

loc(3F) 

rcmd(3X) 

rev(l) 

col(l) 

rev(l) 

lastcomm(l) 

tw(l) 
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ci: check in RCS revisions. ...... .. .. ci(l) 

co: check out RCS revisions. . • ... . ..co(l) 

resdiff: compare RCS revisions.....rcsdiff(l) 

resmerge: merge RCS revisions. ...... .rcsmerge(l) 

fseek, ftell, rewind: reposition a stream. • *••••• .fseek(3S) 

opendir, read dir, telldir, seekdir, rewinddir, ciosedir: directory operations. •.. . directory(3) 

directory: opendir, readdir, telldir, seekdir, rewinddir, ciosedir: directory operations. ........ directory(3X) 

rexec: return stream to a remote command. • ••.•• rexec(3X) 

rexecd: remote execution server. . • • . .rexecd(SC) 

index, rindex, lnblnk, len: tel! about character objects.index(3F) 

stremp, strnemp, strepy, strnepy, strlen, index, rindex: suing operations, streat, strncat, .string(3) 

about RCS files, rlog: print log messages and other information • . . . • rlog(l) 

rlogin: remote login...rlogin(lC) 

rlogind: remote login server. ... rlogind(8C) 

rmdir, rm: remove (unlink) directories or files.rmdir(l) 

rm, rmdir: remove (unlink) files or directories.. rm(l) 

rmaii: handle remote mail received via uuep. ...... rmall(l) 

rmdir: remove a directory file. • •.. . . . . rmdir(2) 

rm, rmdir: remove (unlink) files or directories.rm(l) 

rmdir, rm: remove (unlink) directories or files.rmdir(l) 

rmt: remote magtape protocol module. .*•••.•• rmt(8C) 

robots: fight off villainous robots. • « •. ••••••••..•••• robots(6) 

robots: fight off villainous robots...robots(6) 

roffbib: run off bibliographic database. • . ..roffbib(l) 

rogue: Exploring The Dungeons of Doom.rogue(6) 

pow, sqrt: exponential, logarithm, power, square root, exp, log, loglO, .. . . . exp(3M) 

ebroot: change root directory. .. . . . chroot(2) 

route: manually manipulate the routing tables.route(8C) 

routed: network routing daemon. ..routed(8C) 

inet_netof: Internet address manipulation routines. /inet_ntoa, inet_makeaddr, inetjnaof, . . . . inet(3n) 

tgoto, tputs: terminal independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, ...... termcap(3X) 

setstate: better random number generator; routines for changing generators, /initstate,.random(3) 

command, remd, rresvport, ruserok: routines for returning a stream to a remote .. rcmd(3X) 

routed: network routing daemon. .. routed(8C) 

route: manually manipulate the routing tables. • •.. route(8C) 

network, rrestore: restore a file system dump across the • . . • . rrestore(8C) 

to a remote command, remd, rresvport, ruserok: routines for returning a stream • . • rcmd(3X) 

rsh: remote shell...rsh(lC) 

rshd: remote shell server. ..rshd(8C) 

bit: and, or, xor, not, rshift, lshift bitwise functions. • • . •.bit(3F) 

dstrules: Daylight savings time and time zone name rule file.. .PP ..dstrules(5) 

nice, nohup: run a command at low priority (sh only).nice(l) 

nohup: run command immune to hangups.csh(l) 

nice: run low priority process. .csh(l) 

roffbib: run off bibliographic database.. roffbib(l) 

gcore: get core images of running processes. ...gcore(l) 

renice: alter priority of running processes. .. renice(8) 

ruptime: show host status of local machines.• . ruptime(lC) 

remote command, remd, rresvport, ruserok: routines for returning a stream to a.rcmd(3X) 

rwho: who’s logged in on local machines.. rwho(lC) 

rwhod: system status server. .•••••••••••• rwhod(8C) 

sa, accton: system accounting. ...... .. sa(8) 

Standalone mode: definition of this Sanyo/ICON machine operation mode.. • ••••••• standalone(8) 

.PP dstrules: Daylight savings time and time zone name rule file.dstrules(5) 

brk, sbrk: change data segment size. . ..brk(2) 

scandir: scan a directory...scandir(3) 

scan dir: scan a directory.scandir(3) 

scant, fscanf, sscanf: formatted input conversion. • • . • scanf(3S) 

awk: pattern scanning and processing language.awk(l) 

sccstorcs: build RCS file from SCCS file. • •...• • • sccstorcs(l) 

sees tores: build RCS file from SCCS file.•.sccstorcs(8) 

sccstorcs: build RCS file from SCCS file.sccstorcs(l) 

sccstorcs: build RCS file from SCCS file.sccstorcs(8) 

alarm: schedule signal after specified time.slarm(3C) 

getpriority, setpriority: get/set program scheduling priority. getpriority(2) 

clear: clear terminal screen. • ••••••• .. clear(l) 

curses: screen functions with “optimal” cursor motion.cur$es(3X) 

ex. vi: screen oriented (visual) display editor based on • • . . . vi(ll 

rc: command script for auto-reboot and daemons.rc(8) 

script: make typescript of terminal session.script(l) 

onintr: process interrupts in command scripts. ... csh(l) 

grep, egrep, fgrep: search a file for a pattern. . • • • ..grep(l) 

xsend, xget, enroll: secret mail...xsend(l) 

sed: stream editor. ..sed(l) 

opendir, readdir, telldir, seekdir, rewinddir, ciosedir: directory operations.directory(3) 
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directory: opendir, readdir, teildir, seekdir, rewinddir, closedir: directory operations.directory(3X) 

shmget: get shared memory segment.shmget(2) 

brk, sbrk: change data segment size.brk(2) 

comm: select or reject lines common to two sorted files. . . . . comm(l) 

select: synchronous i/o multiplexing. ... select(2) 

case: selector in switch. ..* csh(l) 

semctl: semaphore control operations. ..semctl(2) 

semop: semaphore operations.semop(2) 

iperm: remove a message queue, semaphore set or shared memory id.. • • • ipcrm(l) 

semget: get set oT semaphores. ... . . semget(2) 

semctl: semaphore control operations.semctl(2) 

semget: get set oT semaphores.semget(2) 

semop: semaphore operations.. semop(2) 

uusend: send a file to a remote host. •••• .uusend(lC) 

send, sendto, sendmsg: send a message from a socket.send(2) 

kill: send a signal to a process.kill(3F) 

mail: send and receive mail. •••• mail(l) 

ping: send ICMP ECHCXJtEQUEST packets to network hosts. ping(8) 

sendmail: send mail over the internet.sendmail(8) 

binmail: send or receive mail among users.. • binmail(l) 

socket, send, sendto, sendmsg: send a message from a .send(2) 

kill: send signal to a process....kill(2) 

killpg: send signal to a process group. •••••••••••• killpg(2) 

sendbug: mail a system bug report to 4bsd-bugs.sendbug(l) 

aliases: aliases file for sendmail.. aliases(5) 

sendmail: send mail over the internet. ..sendmail(8) 

send, sendto, sendmsg: send a message from a socket.send(2) 

send, sendto, sendmsg: send a message from a socket.send(2) 

reset: reset the teletype bits to a sensible state.. reset(l) 

diction,explain: print wordy sentences; thesaurus for diction. ...diction(l) 

explain, diction- print wordy sentences; thesaurus for diction.. . . . . explain(l) 

slattach: attach serial lines as network interfaces. ...slattach(8C) 

comsat: biff server. comsat(8C) 

ftpd: DARPA Internet File Transfer Protocol server.. ftpd(8C) 

rexecd: remote execution server. ..rexecd(8C) 

rlogind: remote login server. ...rlogind(8C) 

rshd: remote shell server.....rshd(8C) 

rwhod: system status server. ..••••. .rwhod(8C) 

talkd: remote user communication server.talkd(8C) 

telnetd: DARPA TELNET protocol server.. ..telnetd(8C) 

tftpd: DARPA Trivial File Transfer Protocol server.....tftpd(8C) 

services: service name data base. •••••• .services(5) 

logout: end session.. • • • ... • • • csh(l) 

script: make typescript of terminal session.... script(l) 

ascii: map of ASCII character set. .... •••• ascii(7) 

stty, gtty: set and get terminal state (defunct).stty(3C) 

sigstack: set and/or get signal stack context.sigstack(2) 

set: change value of shell variable.. csh(l) 

sigsetmask: set current signal mask.... sigsetmask(2) 

umask: set file creation mode mask. ............. umask(2) 

utime: set file times.... utime(3C) 

utimes: set file times. •••••• utimes(2) 

setgroups: set group access list. setgroups(2) 

apply: apply a command to a set of arguments... • • • apply(X) 

semget: get set of semaphores.... semget(2) 

getsockopt, setsockopt: get and set options on sockets.. getsockopt(2) 

bostid: set or print identifier of current host system. •••••• hostid(l) 

hostname: set or print name of current host system.hostname(l) 

iperm: remove a message queue, semaphore set or shared memory id. •••••• ipcrm(l) 

setpgrp: set process group.. • . • • setpgrp(2) 

nice: set program priority...nice(3C) 

setregid: set real and effective group ID. ..setregid(2) 

setreuid: set real and effective user ID’s. ...setreuid(2) 

eYal, exec, exit, export, login, read, readonly, set, shift, times, trap, umask, wait: command/ /cd, . . sh(l) 

getty: set terminal mode. ...getty(8) 

stty: set terminal options. ..... stty(l) 

tabs: set terminal tabs..... tabs(l) 

date: print and set the date. •••• .. date(l) 

sfdate: set the time/date of a file.... sfdate(l) 

setuid, seteuid, setruid, setgid, setegid, setrgid: set user and group ID. .setuid(3) 

setenY: set variable in environment. ..csh(l) 

a stream, setbuf, setbuffer, setlinebuf: assign buffering to.setbuf(3S) 

stream, setbuf, setbuffer, setlinebuf: assign buffering to a • •••••• setbuf(3S) 

setuid, seteuid, setruid, setgid, setegid, setrgid: set user and group ID. • ••••••• setuid(3) 

setenv: set variable in environment. . ... csh(l) 
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Permuted Index 


user and group ID. setuid, 
entry, getfsent, getfsspec, getfsfile, getfstype, 
setuid, seteuid, setruid, 
getgrent, getgrgid, getgrnam, 

getbostent, gethostbyaddr, gethostbyname, 
bost. gethostid, 
gethostname, 
geti timer, 

crypt, 
setbuf, setbuffer, 
getnetent, getnetby&ddr, getnetbyname, 

getpriority, 

getprotoent, get protoby number, getprotobyname, 
getpwent, getpwuid, getpwnam, 


setuid, seteuid, setruid, setgid, setegid, 
consumption, getriimit, 
group ID. setuid, seteuid, 
get6ervent, getservbyport, getservbyname, 

getsockopt, 

for changing/ random, srandom, initstate, 
gettimeofday, 
set user and group ID. 

continue, cd, eval, exec, exit, export, login,/ 

shmctl: 

iperm: remove a message queue, semaphore set or 

shmop: 
shmget: get 

xstr: extract strings from C programs to implement 
chsh: change default login 
exit: leave 
rsh: remote 
system: issue a 
esh: a 
eval: re-evaluate 
popd: pop 
pushd: push 
alias: 

suspend: suspend a 
rshd: remote 
set: change value of 
@: arithmetic on 
unset: discard 
exec: overlay 

/exec, exit, export, login, read, readonly, set, 


long, 
groups: 
ruptime: 
uptime: 
lastcomm: 
netstat: 
uusnap: 
construct a file, what: 

shutdown: 

connection. 

login: 

pause: stop until 
signal: change the action for a 
alarm: schedule 

signal: simplified software 
sigvec: software 
sigsetmask: set current 


seteuid, setruid, setgid, setegid, setrgid: set •••••• 

setfsent, endfsent: get file system descriptor file. 

setgid, setegid, setrgid: set user and group ID. 

setgrent, endgrent: get group file entry. • ••••••• 

setgroups: set group access list. . ... . . 

sethoetent, endhostent: get network host entry. 

setho6tid: get/set unique identifier of current .. 

sethostname: get/set name of current host. •••••• 

setitimer: get/set value of interval timer. • •••••• 

setjmp, longjmp: non-local goto.. . 

setkey, encrypt: DES encryption. 

setlinebuf: assign buffering to a stream. * . .. 

setnetent, endnetent: get network entry. *. 

setpgrp: set process group. ... . . . 

setpriority: get/set program scheduling priority. • • • . 
setprotoent, endprotoent: get protocol entry. •••••• 

setpwent, endpwent: get password file entry.. . 

setquota: enable/disable quotas on a file system. • « • . 

setregid: set real and effective group ID. .. 

setreuid: set real and effective user ID’s. • ... 

setrgid: set user and group ID... 

setrlimit: control maximum system resource . 

setruid, setgid, setegid, setrgid: set user and . 

setservent, endservent: get service entry. • • .. 

setsockopt: get and set options on sockets. • .. 

setstate: better random number generator; routines • • • 

settimeofday: get/set date and time.. • . • 

setuid, seteuid, setruid, setgid, setegid, setrgid: • • • • • 

sfdate: set the time/date of a file. •. 

sh, for, case, if, while, t , • , break, .. 

shared memory control operations.. • 

shared memory id.. 

shared memory operations.. 

shared memory segment.. 

shared strings.. 

shell. 

shell. ... 

shell. 

shell command.. 

shell (command interpreter) with C-like syntax. • • . • 

shell data... 

shell directory stack. ... . . . 

shell directory stack.. 

shell macros. ..... . . . 

shell, resuming its superior. • • . ... • • • 

shell server.. . . .. 

shell variable. 

shell variables... 

shell variables.... 

shell with specified command. •••••••••••• 

shift: manipulate argument list.. 

shift, times, trap, umask, wait: command language. . • . 

shmctl: shared memory control operations.. 

shmget: get shared memory segment. 

shmop: shared memory operations. •••••••••• 

short: integer object conversion.. . . . 

show group memberships. •••••••••••••• 

show host status of local machines. . . • .. 

show how long system has been up. • . • . .. 

show last commands executed in reverse order. . . • • . 

show network status.. . 

show snapshot of the UUCP system. • •*••••*• 
show what versions of object modules were used to • • . 

shut down part of a full-duplex connection. 

shutdown: close down the system at a given time. • . . 

shutdown: shut down part of a full-duplex.. . 

sigblock: block signals.. . . . 

sign on. 

signal. . .... 

signal. 

signal after specified time. ... . . . • 

signal: change the action for a signal. .. 

signal facilities.. 

signal facilities. . .. 

signal mask. . . . .. 


setuid(3) 

getfsent(3X) 

setuid(3) 

getgrent(3) 

setgroups(2) 

gethostent(3n) 

gethostid (2) 

gethostname(2) 

getitimer(2) 

setjmp(3) 

crypt(3) 

setbuf(3S) 

getnetent(3n) 

**tpgrp(2) 

getpriority (2) 

getprotoent(3n) 

getpwent(3) 

setquota(2) 

aetregid(2) 

setreuid(2) 

setuid(3) 

getrlimit(2) 

setuid(3) 

getservent(3n) 

getsockopt(2) 

random(3) 

gettimeorday(2) 

8etuid(3) 

sfdatefl) 

8h(l) 

shmctl(2) 

ipcrm(l) 

8hmop(2) 

shmget(2) 

xstr(l) 

chsh(l) 

csh(l) 

rsh(lC) 

system(3) 

csh(l) 

csh(l) 

csh(l) 

csh(l) 

esh 1) 

cshfl) 

rehd(8C) 

cshfl) 

cshfl 

csh(l) 

csh(l) 

cshfl) 

sh(l) 

shmctl(2) 

shmget(2) 

shmop(2) 

long(3F) 

groups(l) 

ruptime(lC) 

uptime(I) 

lastcomm(l) 

netstat(l) 

uusnap(8C) 

what(l) 

shutdown (2) 

shutdown(8) 

shutdown(2) 

sigblock (2) 

login(l) 

pause(3C) 

signal(3F) 

alarm(3C) 

signal(3F) 

signal(3C) 

sigvec(2) 

sigsetmask(2) 
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Permuted Index 


psignal, 8 ya_ 3 iglist: system 

sigstack: set and/or get 
kill: send 
kill: send a 
killpg: send 
sigblock: block 
sigpause: atomically release blocked 
wait for interrupt. 


signal: 
tc: photoypesetter 
trigonometric functions. 

null: data 

brk, sbrk: change data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
pagesize: print system page 
size: 

interfaces. 


dosprinters: destinations for spooled output from 

spline: interpolate 

uusnap: show 
snake, 

accept: accept a connection on a 
bind: bind a name to a 
connect: initiate a connection on a 
listen: listen for connections on a 
reev, recvfrom, recvmsg: receive a message from a 
send, sendto, sendmsg: send a message from a 

getsockname: get 

getsockopt, setsockopt: get and set options on 
socketpair: create a pair of connected 

signal: simplified 
sigvec: 

canfield, cfscores: the 
qsort: quicker 
qsort: quick 
tsort: topological 
sortbib: 
sort: 


comm: select or reject lines common to two 
look: find lines in a 
soelim: eliminate 
soelim: eliminate . 
indent: indent and format C program 
mkstr: create an error message file by massaging C 

whereis: locate 

line, cirde, arc, move, cont, point, linemod, 
expand, unexpand: expand tabs to 
way. vfork: 
exec: overlay shell with 
truncate: truncate a file to a 
alarm: schedule signal after 
alarm: execute a subroutine after a 
swapon: 
swap on: 

spell, 

spell, spellin, spellout: find 
spell, spellin, 


signal messages. .. 

signal: simplified software signal facilities.. 

signal stack context... 

signal to a process. ..... 

signal to a process. 

signal to a process group... 

signals. .... 

signals and wait for interrupt. 

sigpause: atomically release blocked signals and. 

sigsetmask: set current signal mask.. . • • 

sigstack: set and/or get signal stack context. •••••• 

sigvec: software signal facilities. 

simplified software signal facilities. 

simulator.... 

sin, cos, tan, asin, aco6, atan, atan2: . 

sinh, cosh, tanh: hyperbolic functions. ••••••••• 

sink. 

size..... 

size.... 

size. •• . 

size. •••••• .. 

size of an object file.. . 

size: size of an object file. 

slattach: attach serial lines as network . 

sleep: suspend execution for an interval.. • • • 

sleep: suspend execution for an interval. 

sleep: suspend execution for interval. ••••••••• 

SLPT printers. ••••• . 

smooth curve. •••• .. 

snake, snscore: display chase game.. 

snapshot of the UUCP system. .. 

snscore: display chase game. 

socket. ..... 

socket.. .. 

socket. ••••• . 

socket... 

socket... 

socket. .... 

socket: create an endpoint for communication. 

socket name... 

socketpair: create a pair of connected sockets. 

sockets. 

sockets... 

soelim: eliminate .so’s from nroff input. ... 

software signal facilities... 

software signal facilities... 

solitaire card game canfield.. 

sort. ••••••.•••••• 

sort. .. ••••••• 

sort. ... 

sort bibliographic database. ••••••••••••• 

sort or merge files. . 

sort: sort or merge files.. 

sortbib: sort bibliographic database. . . . . 

sorted files. ... . . . 

sorted list. . 

.so’s from nroff input. 

so’s from nroff input... 

source. ..... 

source.... 

source, binary, and or manual for program. 

source: read commands from file.. . . . 

space, closepl: graphics interface, /erase, label,. 

spaces, and vice versa. .. . . . . 

spawn new process in a virtual memory efficient . . . . 

specified command.. . 

specified length. 

specified time. ... . . . 

specified time..... 

specify a swap directory. ... 

specify additional device for paging and swapping. . . . 

spell, spellin, spellout: find spelling errors. 

spellin, spellout: find spelling errors. ••••••••• 

spelling errors. .. 

spellout: find spelling errors... 


psignal(3) 

signal(3C) 

sigstack (2) 

kill(2) 

kill(3F) 

killpg(2) 

sigblock (2) 

sigpause(2) 

sigpause(2) 

sigsetmask (2) 

sigstack(2) 

sigvec(2) 

signal(3C) 

Mi) 

sin(3M) 

sinh(3M) 

null(4) 

brk(2) 

getdtablesize(2) 

getpagesize(2) 

pagesize(l) 

size(l) 

size(l) 

slattach(8C) 

sleep(l) 

sleep(3F) 

sleep(3) 

dosprinters(5) 

spline(lG) 

snake(fi) 

uusnap(8C) 

snake(6) 

accept(2) 

bind(2) 

connect(2) 

listen(2) 

recv(2) 

send(2) 

socket(2) 

getsockname(2) 

socketpair(2) 

getsockopt(2) 

socketpair(2) 

soelim(l) 

signal(3C) 

sigvec(2) 

canfield(6) 

qsort(3) 

qsort(3F) 

tsort(l) 

sortbib(l) 

sort(l) 

sort(l) 

sortbib(l) 

comm(l) 

look(l) 

soelim(l) 

soelim(l) 

indent(l) 

mkstr(l) 

whereis(l) 

csh(l) 

plot(3X) 

expand(l) 

vfork (2) 

«h(l) 

truncate(2) 

alarm(3C) 

alarm(3F) 

swapon(2l 

swapon (8) 

spell(l) 

spell (l) 

spell(l) 

spell (1) 
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split: 
files. fsplit: 
frexp, Idexp, modf: 

unclean: uucp 
lpq: 

dosprinters: destinations for 
dosprint: MPS/DOS 
Iprra: remove jobs from the line printer 
printf, fprintf, 
exp, log, ioglO, pow, 
loglO, pow, sqrt: exponential, logarithm, power, 

rand, 

generator; routines for changing/ random, 
scanf, fscanf, 

popd: pop shell directory 
pushd: push shell directory 
sigstack: set and/or get signal 
copy: 
dkfmt: 

machine operation mode., 
bload: program to load 
stdio: 

htabie: convert NIC 


reset: reset the teletype bits to a sensible 
stty, gtty: set and get terminal 
fsync: synchronize a file’s in-core 
if: conditional 
fst&b: 

hashstat: print command hashing 
iostat: report I/O 
vmstat: report virtual memory 
exit: terminate process with 
ipcs: report inter-process communication facilities 
netstat: show network 
ps: process 
st&t, istat, fstat: get file 
stat, Istat, fstat: get file 
ferror, feof, clearerr, fileno: stream 
sysline: display system status on 
ruptime: show host 
sysline: display system 
rwhod: system 


halt: 
pause: 
icheck: file system 
subroutines, dbminit, fetch, 
strlen, index, rindex: string operations, 
rindex: string operations, strcat, strncat, 
operations, strcat, strncat, strcmp, strncmp, 
fclose, fflush: close or flush a 
fopen, freopen, fdopen: open a 
fseek, ftell, rewind: reposition a 
getchar, fgetc, getw: get character or word from 
gets, fgets: get a string from a 
putchar, fputc, putw: put character or word on a 
puts, fputs: put a string on a 
setbuffer, setlinebuf: assign buffering to a 
ungetc: push character back into input 

sed: 

ferror, feof, clearerr, fileno: 
rcmd, rresvport, ruserok: routines for returning a 

rexec: return 

fdale: return date and time in an ASCII 
gets, fgets: get a 
puts, fputs: put a 
bcopy, bcmp, bzero, ffs: bit and byte 
strncmp, strcpy, strncpy, strlen, index, rindex: 


spline: interpolate smooth curve. . .. 

split a file into pieces... 

split a multi-routine Fortran file into individual • . • . 

split into mantissa and exponent.. 

split: split a file into pieces. .. 

spool directory clean-up. 

spool queue examination program. • • • •. 

spooled output from SLPT printers. 

spooler daemon.... . . . . 

spooling queue. • 

sprintf: formatted output conversion.. . . . . 

sqrt: exponential, logarithm, power, square root. 

square root, exp, log,... 

srand: random number generator. 

srandom, initstate, setstate: better random number • . . 

sscanf: formatted input conversion. 

stab: symbol table types. ... . . . 

stack. 

stack.. . . . ... 

stack context.... • . . . 

standalone copy program.. ... 

standalone disk formatter. .. 

Standalone mode: definition of this Sanyo/ICON . . . . 

standalone programs. • •••••••• .. 

standard buffered input/output package. ....... 

standard format host tables.. 

stat, Istat, fstat: get file status. • •••.••••••• 

stat, Istat, fstat: get file status. .. 

state. 

state (defunct)..... 

state with that on disk. ... . . • 

statement... 

static information about the filesystems. 

statistics... 

statistics.. 

statistics. .. 

status. •... 

status. . ... .. 

status.. 

status. .. .. 

status. • .... 

status. . ... . . .. 

status inquiries... 

status line of a terminal. • • • .. 

status of local machines. . • . • ... 

status on status line of a terminal. •••••«•••• 

status server... 

stdio: standard buffered input/output package. . . . . • 
sticky: executable files with persistent text. ...... 

stop: halt a job or process... 

stop the processor. ... .. 

stop until signal. .... . • . 

storage consistency check. .... 

store, delete, firstkey, nextkey: data base ....... 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, • • • • 
strcmp, strncmp, strcpy, strncpy, strlen, index, • • • • • 

strcpy, strncpy, strlen, index, rindex: string . 

stream. .. 

stream. ... 

stream... 

stream, getc, .... • 

stream. ... 

stream, putc, . 

stream. .... 

stream, setbuf, .. 

stream... 

stream editor.. . .. 

stream status inquiries... 

stream to a remote command. . 

stream to a remote command. . 

string.. 

string from a stream. 

string on a stream. 

string operations. .. 

string operations, strcat, strncat, strcmp, .. • 


spline(lG) 

split(l) 

fsplit(l) 

frexp(3) 

split(l) 

uuclean(8C) 

Ml) 

dosprinters(5) 

dosprint(8) 

lprm(l) 

printfi(3S) 

exp(3M) 

«xp(3M) 

rand(3C) 

random(3) 

scanf(3S) 

stab(5) 

csh(l) 

csh(l) 

sigstack (2) 

copy(8) 

dkfmt(8) 

standaJone(8) 

bload(8) 

intro(3S) 

htable(8) 

stat(2) 

stat(3F) 

reset(l) 

stty(3C) 

fsync(2) 

csh(l) 

fstab(5) 

csh(l) 

iostat(l) 

vmstat(l) 

exit(3F) 

ipcs(l) 

netstat(l) 


stat(3F) 

ferror(3S) 

sysline(l) 

ruptime(lC) 

sysline(l) 

rwhod(8C) 

intro(3S) 

sticky (8) 

csh(l) 

halt(8) 

pause(3C) 

icheck (8) 

dbm(3X) 

string(3) 

string(3) 

string(3) 

fclose(3S) 

fopen(3S) 

fseek(3S) 

getc(3S) 

gets(3S) 

putc(3S) 

puts(3S) 

setbuf(3S) 

ungetc(3S) 

sed(l) 

ferror(3S) 

rcmd(3X) 

rexec(3X) 

fdate(3F) 

gets(3S) 

puts(3S) 

bstring(3) 

string(3) 
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extract strings from C programs to implement shared 

other binary, file, 
strings, xstr: extract 
strings: find the printable 
basename: 

streat, strncat, stremp, strnemp, strepy, strnepy, 
index, rindex: string operations, streat, 
string operations, streat, strncat, stremp, 
streat, strncat, stremp, strnemp, strepy, 

struct: 


document. 

alarm: execute a 
fetch, store, delete, firstkey, nextkey: data base 

lib2648: 

su: 

sum: 

du: 
quot: 
repquota: 
sync: update the 
update: periodically update the 
sync: update 

suspend: suspend a shell, resuming its 
style: analyze 
suspend: 
sleep: 
sleep: 
sleep: 


swab: 

swapon: specify a 
swapping. 

swapon: specify additional device for paging and 
breaksw: exit from 
case: selector in 
default: catchall clause in 
endsw: terminate 

stab: 

readlink: read value of a 
symlink: make 
strip: remove 


disk, fsync: 
select: 

esh: a shell (command interpreter) with C-like 

perror, 

terminal. 


perror, sys_errlist, 
psignal, 

jove_recover - recover JOVE buffers after a 
mkfs: program to make UNIX file 
syslog: log 

kgmon: generate a dump of the operating 
rehash: recompute command bash 
unhash: discard command hash 
mtab: mounted file system 
getdtablesize: get descriptor 
stab: symbol 

htable: convert NIC standard format host 
route: manually manipulate the routing 


strings, xstr: ... 

strings: find the printable strings in a object, or * . . . 

strings from C programs to implement shared . 

strings in a object, or other binary, file. .. 

strip filename affixes. .. 

strip: remove symbols and relocation bits. 

strlen, index, rindex: string operations.. 

strncat, stremp, strnemp, strepy, strnepy, strlen, • . • • 

strnemp, strepy, strnepy, strlen, index, rindex: . 

strnepy, strlen, index, rindex: string operations. 

struct: structure Fortran programs.. 

structure Fortran programs. • .. 

stty, gtty: set and get terminal state (defunct). 

stty: set terminal options. 

style: analyze surface characteristics of a •••••••• 

su: substitute user id temporarily. ... . 

subroutine after a specified time. . • .. 

subroutines, dbminit... 

subroutines for the HP 2648 graphics terminal. . . . . . 

substitute user id temporarily. . • . 

sum and count blocks in a file. . • . 

sum: sum and count blocks in a file. • • . 

summarize disk usage. 

summarize file system ownership. 

summarize quotas for a file system. 

super block. . 

super block. 

super-block. . . ... 

superior. .. 

surface characteristics of a document. . 

suspend a shell, resuming its superior. 

suspend execution for an interval. . 

suspend execution for an interval. .. 

suspend execution for interval. .. 

suspend: suspend a shell, resuming its superior. 

swab: swap bytes. ••••*•••••••••••• 

swap bytes. . 

swap directory....... • 

swapon: specify a swap directory. 

swapon: specify additional device for paging and • • • • 

swapping. .• . . . •.. 

switch..... 

switch..... 

switch. .. • • • 

switch.. 

switch: multi-way command branch.. . . 

symbol table types. • ••••• .. 

symbolic link. .... . . . . 

symbolic link to a file.. 

symbols and relocation bits.. . . . . 

symlink: make symbolic link to a file. 

symorder: rearrange name list. 

sync: update super-block... 

sync: update the super block.. 

synchronize a file’s in-core state with that on •••••• 

synchronous i/o multiplexing. .. . 

syntax.... 

syscall: indirect system call.. 

syswerrlist, sys_nerr: system error messages. . 

sysline: display system status on status line of a • • • . 

syslog: log systems messages.. . . 

syslog, openlog, closelog: control system log. 

sys_nerr: system error messages. 

sys.jsiglist: system signal messages. 

system/editor crash. • • .. 

systems... 

systems messages. 

system’s profile buffers.. . . 

table.. 

table.. 

table. . . . ... 

table size. .. 

table types. 

tables. 

tables. . 


xstr(l) 

strings(l) 

xstr(l) 

strings(l) 

basename(l) 

strip(I) 

string(3) 

string(3) 

string(3) 

string(3) 

struct(l) 

struct(l) 

•tty(3C) 

•tty(l) 

style(l) 

su(l) 

alarm(3F) 

dbm(3X) 

lib2648(3X) 

su(l) 

sum(l) 

sum(l) 

du(l) 

quot(8) 

repquota(8) 

sync(8) 

update(8) 

sync(2) 

csh(l) 

8tyle(l) 

csh(l) 

sleep(l) 

sleep(3F) 

sleep(3) 

csh(I) 

swab 13} 

swab (3) 

swapon(2) 

swapon(2) 

swapon(8) 

swapon(8) 

csh(l) 

csh(l) 


csh(l) 

csh(l) 

csh(l) 

stab(5) 

readlink (2) 

symlink(2) 

strip(l) 

symlink(2) 

symorder(l) 

sync(2) 

sync(8) 

fsync(2) 

select(2) 

csh(l) 

syscall(2) 

perror(3) 

sysline(l) 

*yslog(8) 

*yslog(3) 

perror(3) 

psignal(3) 

jove_recover(l) 

mkfs(8) 

syslog(8) 

kgmon(8) 

csh(l) 

csh(l) 

mtab (5) 

getdtablesize(2) 

stab (5) 

htable(8) 

route(8C) 
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Permuted Index 


tbl: format 
gettable: get NIC format host 
tabs: set terminal 

expand, unexpand:expand 
Hags: create a 


talk: 


functions, sin, cos, 
sinh, cosh, 
tcopy: copy a mag 
tar: 
tar: 

tclose, tread, twrite, trewin, tskipf, tstate: f77 

mt: magnetic 


deroff: remove nroff, troff, 


tape I/O. topen, 


tk: paginator for the 
reset: reset the 
last: indicate last logins of users and 
index, rindex, lnblnk, len: 
operations, opendir, readdir, 
operations, directory: opendir, readdir, 
telnet: user interface to the 
telnetd: DARPA 


su: substitute user id 


lib2648: subroutines for the HP 2648 graphics 

lock: reserve a 

sysline: display system status on status line of a 
ttyname, isatty, ttyslot: find name of a 
vhangup: virtually “hangup” the current control 
worms: animate worms on a display 
termcap: 
gettytab: 
tset: 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: 

ttys: 
tty: general 
getty: set 
tty: get 
stty: set 

ttynam, isatty: find name of a 
clear: clear 
script: make typescript of 
stty, gtty: set and get 
tabs: set 
ttytype: data base of 
term: conventional names for 
wait, wait3: wait for process to 
wait: wait for a process to 
.exit: 
output, exit: 
kill: 
abort: 
endif: 
end: 
exit: 
endsw: 


quiz: 

sticky: executable files with persistent 

ed: 


tables for nroff or troff. .. 

tables from a host.. . - .. 

tabs. .... 

tabs: set terminal tabs.. . . . . 

tabs to spaces, and vice versa. 

tap file. • ... 

tail: deliver the last part of a file.. 

talk: talk to another user. 

talk to another user... 

talkd: remote user communication server. 

tan, asin, acos, at an, atan2: trigonometric . 

tanh: hyperbolic functions. ••••••••••••• 

tape. ... . . . .. 

tape archive file format. .. 

tape archiver. ••••••••••••••••••• 

tape I/O. topen,. 

tape manipulating program. ... 

tar: tape archive file format. .. 

tar: tape archiver.. . . . 

tbl and eqn constructs. . ». 

tbl: format tables for nroff or troff.. . . . 

tc: photoypesetter simulator. ••••••••••••• 

tclose, tread, twrite, trewin, tskipf, tstate: f77 . 

tcopy: copy a mag tape. ••••••••••*•••• 

TEACHJOVE - learn how to use the JOVE editor. • • . 

tee: pipe fitting. ... 

Tektronix 4014. 

teletype bits to a sensible state. .. 

teletypes. ... 

tell about character objects. . • ... 

telldir, seekdir, rewind dir, dosedir: directory . 

telldir, seekdir, rewinddir, closedir: directory *.. 

TELNET protocol. 

TELNET protocol server. .. 

telnet: user interface to the TELNET protocol. . . . . . 
telnetd: DARPA TELNET protocol server. •••••• 

temporarily.. • • . . 

term: conventional names for terminals. .. 

termcap: terminal capability data base. 

terminal. «... .. 

terminal.. 

terminal.. . 

terminal. .. 

terminal.. 

terminal.. 

terminal capability data base. .. 

terminal configuration data base. • ••*••*•••• 

terminal dependent initialization. • . . • .. 

terminal independent operation routines. 

terminal initialization data. .. 

terminal interface. ... 

terminal mode... 

terminal name.. 

terminal options.. . ... 

terminal port... 

terminal screen. .. 

terminal session. ... 

terminal state (defunct).. . .. 

terminal tabs.... 

terminal types by port. .. 

terminals. . 

terminate... 

terminate. ..... 

terminate a process.. 

terminate a process after flushing any pending • • • • . 
terminate a process with extreme prejudice. •••••• 

terminate abruptly with memory image. *••••••. 

terminate conditional. ..*. 

terminate loop. ... . . . 

terminate process with status... 

terminate switch.. 

test: condition command. .. 

test your knowledge.. 

text... 

text editor. ... 


tbi(l) 

gettable(8C) 

tabs(l) 

tabs(l) 

expand(l) 

ctags(l) 

tail(l) 

talk(l) 

talk(l) 

talkd(8C) 

sin(3M) 

sinh(3M) 

tcopy(I) 

tar(5) 


tar(l) 
topen (3F) 
mt(l) 
tar(5) 


tar(l) 

deroff(l) 

tbl(l) 

tc(l) 

topen (3F) 

tcopy(l) 

teachjove(l) 

tee(l) 

tk(l) 

reset(l) 

last(l) 

index(3F) 

directory (3) 

directory (3X) 

telnet(lC) 

telnetd(SC) 

telnet(lC) 

telnetd(8C) 

su(l) 

term(7) 

termcap(5) 

lib2648(3X) 

lock(l) 

sysline(l) 

ttyname(3) 

vhangup(2) 

worms(6) 

termcap(5) 

gettytab (5) 

tset(l) 

termcap(3X) 

ttys(5) 

tty(4) 

getty(8) 

tty(l) 

»tty(l) 

ttynam(3F) 

elear(l) 

script(l) 

stty(3C) 

tabs(l) 

ttytype(5) 

term(7) 

wait(2) 

wait(3F) 

e»t(2) 

edt(3) 

kill(l) 

abort(3F) 

csh(l) 

csh(l) 

exit(3F) 

csh(l) 

test(l) 

qutz(6) 

sticky(8) 

ed(l) 


liv 
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Permuted Index 


ex, edit: text editor. .. ex(l) 

jove: an Interactive display-oriented text editor. .. jove(l) 

fmt: simple text formatter. ..••••••• .fmt(l) 

nroff: text formatting. ♦.. nroff(l) 

troff, nroff: text formatting and typesetting.. troffjl) 

ms: text formatting macros. ..ms(7) 

tftp: trivial file transfer program...tftp(lC) 

tftpd: DARPA Trivial File Transfer Protocol server. • . tftpd(8C) 
terminal independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: • • • • termcap(3X) 

independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal .••••••• termcap(3X) 

independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal • • • • termcap(3X) 

operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent.termcap(SX) 

routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation.termcap(3X) 

diction,explain: print wordy sentences; thesaurus for diction...diction(l) 

explain, diction- print wordy sentences; thesaurus for diction.. . . explain(l) 

merge: three-way file merge.merge(l) 

alarm: schedule signal after specified time...alarm(3C) 

alarm: execute a subroutine after a specified time.•.• alarm(3F) 

at: execute commands at a later time.. . . ..at(l) 

etime, dtime: return elapsed execution time.. . ... etime(3F) 

gettimeofday, settimeofday: get/set date and time...gettimeofday(2) 

shutdown: close down the system at a given time. .... shutdown(8) 

time, ftime: get date and time. ••••••• .. time(3C) 

time, etime, ltime, gmtime: return system time. ••••• .time(3F) 

time: time a command. ••••••• time(l) 

PP dstrules: Daylight savings time and time zone name rule file.. • • • • dstrules(S) 

time: time command.csh(l) 

time, etime, ltime, gmtime: return system time. • • • • • time(3F) 

time, ftime: get date and time.time(3C) 

fdate: return date and time in an ASCII string.fdate(3F) 

idate, itime: return date or time in numerical form. ..idate(3F) 

profil: execution time profile...profil(2) 

time: time a command...time(l) 

time: time command... •••• csh(l) 

gmtime, asetime, timezone: convert date and time to ASCII, etime, localtime, ctime(3) 

PP dstrules: Daylight savings time and time zone name rule file.dstrules(5) 

sfdate: set the time/date of a file. • ..sfdate(l) 

getitimer, setitimer: get /set value of interval timer...getitimer(2) 

times: get process times.times(3C) 

utime: set file times. utime(3C) 

utimes: set file times.. ... utimes(2) 

times: get process times. ..times(3C) 

exit, export, login, read, readonly, set, shift, times, trap, umask, wait: command language, /exec, • . sh(l) 

etime, localtime, gmtime, asetime, timezone: convert date and time to ASCII. .•••••• ctime(3) 

tip, cu: connect to a remote system. ••....•.•• tip(lC) 

tk: paginator for the Tektronix 4014. •••....•• tk(l) 

tmail: print out mail messages, most recent first. • • • • tmail(l) 

popen, pclose: initiate I/O to/from a process. ..... popen(3) 

tstate: f77 tape I/O. topen, tclose, tread, twrite, trewin, tskipf, ....... topen(3F) 

tsort: topological sort. tsort(l) 

touch: update date last modified of a file. • ..touch(l) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation routines. .... termcap(3X) 

tr: translate characters. • • • ... • • • • tr(l) 

ptrace: process trace.... ptrace(2) 

trpt: transliterate protocol trace. ... trpt(8C) 

goto: command transfer.. • • . • esb(l) 

kermit: kermit file transfer.. . kermit(l) 

ftp: file transfer program... ftp(lC) 

tftp: trivial file transfer program. tftp(lC) 

ftpd: DARPA internet File Transfer Protocol server.ftpd(8C) 

tftpd: DARPA Trivial File Transfer Protocol server.tftpd(8C) 

tr: translate characters. ...tr(l) 

macros, trman: translate version 6 manual macros to version 7 • • • • • trman(l) 

pi: Pascal interpreter code translator. ..pi(l) 

trpt: transliterate protocol trace. .. •••••• trpt(8C) 

uuencode,uudecode: encode/decode a binary file for transmission via mail. ... uuencode(lC) 

trpfpe, fpeent: trap and repair floating point faults.trpfpe(3F) 

trapov: trap and repair floating point overflow. ..trapov(3F) 

traper: trap arithmetic errors.traper(3F) 

export, login, read, readonly, set, shift, times, trap, umask, wait: command language, /exec, exit, ... sh(l) 

traper: trap arithmetic errors. ..traper(3F) 

trapov: trap and repair floating point overflow. • • • • • trapov(3F) 

I/O. topen, tclose, tread, twrite, trewin. tskipf, tstate: 177 tape .topen(3F) 

trek: trekkie game. ..trek(6) 

trek: trekkie game.trek(6) 
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Permuted Index 


topes, tclose, tread, twrite, trewin, tskipf, tstate: f77 tape I/O. . • ... 

sin, coe, tan, sain, acos, alas, atan2: trigonometric functions. . .... 

tftp: trivial file transfer program. .. 

fcfltpd: DARPA Trivial File Transfer Protocol server. 

7 macros, trman: translate version 6 manual macros to version • . 

tbl: format tables for nroff or troff. • • .... 

troff, nroff: text formatting and typesetting. 

deroff: remove nroff, troff, tbl and eqn constructs. 

battlestar: a tropical adventure game. . . .... 

faults, trpfpe, fpeent: trap and repair floating point •••••• 

trpt: transliterate protocol trace.. 

true, false: provide truth values. .. 

false, true: provide truth values. 

truncate: truncate a file to a specified length. 

truncate: truncate a file to a specified length. •••••• 

false, true: provide truth values. • . 

true, false: provide truth values. 

tset: terminal dependent initialization. 

topen, tclose, tread, twrite, trewin, tskipf, tstate: f77 tape I/O. 

tsort: topological sort.. 

topen, tclose, tread, twrite, trewin, tskipf, tstate: f77 tape I/O.. 

tty: general terminal interface... 

tty: get terminal name.. . . .. 

ttynam, isatty: find name of a terminal port. 

ttyname, isatty, ttyslot: find name of a terminal. 

ttys: terminal initialization data. 

ttyname, isatty, ttyslot: find name of a terminal. • • • ... 

ttytype: data base of terminal types by port.. 

tunefs: tune up an existing file system. 

tunefs: tune up an existing file system.. 

topen, tclose, tread, twrite, trewin, tskipf, tstate: f77 tape I/O. ••••... 

file: determine file type.... 

stab: symbol table types. ... 

types: primitive system data types.. 

ttytype: data base of terminal types by port. ... 

types: primitive system data types. 

script: make typescript of terminal session. . . . ... . . 

man: macros to typeset manual... 

eqn, neqn, checkeq: typeset mathematics. .. 

troff, nroff: text formatting and typesetting.... 

getpw: get name from uid. .... 

ul: do underlining.. .. 

umask: change or display file creation mask.. 

umask: set file creation mode mask. 

login, read, readonly, set, shift, times, trap, umask, wait: command language, /exec, exit, export, . . 

mount, umount: mount and dismount file system. ••••.•• 

mount, umount: mount or remove file system. 

unalias: remove aliases. .. 

cat them, compact, uncompact, ccat: compress and uncompress files, and • • 

compact, uncompact, ccat: compress and uncompress files, and cat them.. . 

compress, uncompress, zcat: compress and expand data. . 

ul: do underlining. ... 

expand, unexpand: expand tabs to spaces, and vice versa. • • • . 

ungetc: push character back into input stream. • • • • • 

unhash: discard command hash table. 

unifdef: remove ifdefed lines. 

uniq: report repeated lines in a file. 

mktemp: make a unique file name. 

getboetid, sethostid: get/set unique identifier of current host. *.. • 

flush: flush output to a logical unit. 

fseek, ftell: reposition a file on a logical unit... 

getc, fgetc: get a character from a logical unit. • • .. . . . . 

putc, fputc: write a character to a fortran logical unit. 

units: conversion program. 

learn: computer aided instruction about UNIX.... 

reboot: UNIX bootstrapping procedures.. 

system: execute a UNIX command. 

uuxtunixto unix command execution... 

uucp, uulog: unix to unix copy... 

mkfs: program to make UNIX file systems..... 

uux: unix to unix command execution.. . . . . 

uucp, uulog: unix to unix copy. ... . . . .. 

unlimit: remove resource limitiations. 

rmdir, rm: remove (unlink) directories or files... 

rm, rmdir: remove (unlink) files or directories. 


topen(3F) 

sin(3M) 

tftp(IC) 

tftpd(8C) 

trman(l) 

tbl(l) 

troff(l) 

deroff(l) 

battlestar(6) 

trpfpe(3F) 

trpt(SC) 

true(l) 

false(l) 

truncate(2) 

truncate(2) 

false(l) 

true(l) 

tset(l) 

topen(3F) 

tsort(l) 

topen (3F) 



ttynam(3F) 

ttyname(3) 

ttys(5) 

ttyname(3) 

ttytype(5) 

tunefs(8) 

tunefs(8) 

topen(3F) 

aie(X) 

stab(5) 

types(5) 

ttytype(5) 

types(5) 

script(l) 

man(7) 

eqn(l) 

troff(l) 

getpw(3C) 

ul(l) 

csh(l) 

umask(2) 

sh(I) 

mount(8) 

mount(2) 

csh(l) 

compact(l) 

compact(l) 

compress(l) 

ul(l) 

expand(l) 

ungetc(3S) 

csh(l) 

unifdef(l) 

uniq(l) 

mktemp(3) 

gethostid(2) 

flush(3F) 

fseek(3F) 

getc(3F) 

putc(3F) 

unitsfl) 

learn(I) 

reboot(8) 

system(3F) 

uux(lC) 

uucp(lC) 

mkfs(8) 

uux(lC) 

uucp(lC) 

csh(l) 

rmdir(l) 

rm(l) 


lvi 
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uptime: show how long system has been 
tuners: tune 
touch: 

sync: 

sync: 

update: periodically 

du: summarize disk 
quota: display disc 
TEACHJOVE - learn how to 
what: show what versions of object modules were 
miscellaneous: miscellaneous 
login: login new 
talk: talk to another 
write: write to another 
seteuid, setruid, setgid, setegid, setrgid: set 
talkd: remote 
environ: 

whoami: print effective current 
su: substitute 
getuid, geteuid: get 
setreuid: set real and effective 
finger: 
telnet: 
getuid, getgid: get 
edquota: edit 
adduser: procedure for adding new 
binmail: send or receive mail among 
wall: write to all 
whodos: display information about dose 
last: indicate last logins of 

getlog: get 
users: compact list of 
getrusage: get information about resource 
vtimes: get information about resource 


rmail: handle remote mail received via 
uuclean: 

uusnap: show snapshot of the 

transmission via mail, uuencode, 
uuencode: format of an encoded 

transmission via mail. 

uucp, 


abs: integer absolute 
fabs, floor, ceil: absolute 
getenv: 
readlink: read 
getenv: get 
getitimer, setitimer: get/set 
set: change 
false, true: provide truth 
dfimin, dflmax, dffrac, inmax: return extreme 
rand, drand, irand: return random 
true, false: provide truth 
htonl, htons, ntohl, ntohs: convert 

set: change value of shell 
varargs: 
setenv: set 


unlink: remove a directory entry. »*•»••• 

unlink: remove directory entry. • • .. 

unset: discard shell variables. •••••••• 

unsetenv: remove environment variables. • . • 

up. 

up an existing file system. .. 

update date last modified of a file. 

update: periodically update the super block. • • 

update super-block. . . . .. 

update the super block. 

update the super block. . 

uptime: show how long system has been up. • . 

usage. 

usage and limits. • • . .. 

use the JOVE editor. .. 

used to construct a file. 

useful information pages. 

user. .... 

user. . .... 

user. . . .. 

user and group ID. setuid, . 

user communication server. 

user environment.. * • 

user id. . ♦ .... 

user id temporarily... 

user identity... 

user ID’s. • • ... • • 

user information lookup program.. 

user interface to the TELNET protocol. • • • . 

user or group ID of the caller. 

user quotas. .. 

users... 

users. .... 

users. ... 

users... 

users and teletypes... 

users: compact list of users who are on the system. 

user's login name. 

users who are on the system. 

utilization. . 

utilization. 

utime: set file times. . 

utimes: set file times. . .. 

utmp, wtmp: login records. ... 

uuclean: uucp spool directory clean-up. • • • • 

uucp.•. 

uucp spool directory clean-up. ........ 

UUCP system.... 

uucp, uulog: unix to unix copy.. . . 

uudecode: encode/decode a binary file for ... 

uuencode file... 

uuencode: format of an encoded uuencode file, 
uuencode,uudecode: encode/decode a binary file for 

uulog: unix to unix copy.. • . • 

uusend: send a file to a remote host. • . • . . 
uusnap: show snapshot of the UUCP system. 

uux: unix to unix command execution. 

uxrc: configuration file for kernel. 

valloc: aligned memory allocator. 

value. 

value, floor, ceiling functions. •••••••• 

value for environment name. 

value of a symbolic link.. • • • 

value of environment variables. 

value of interval timer.. 

value of shell variable. ... . . . 

values. ... 

values, flmin, flmax, ffrac,. 

values. . .... 

values.. . • . 

values between host and network byte order. • • 
varargs: variable argument list. ••••••• 

variable. 

variable argument list. 

variable in environment. 


unlink(3F) 

unlink(2) 

csh(l) 

esh(l) 

uptime(l) 

tunefs(8) 

touch(l) 

update(8) 

sync(2) 

»ync(8) 

update(8) 

uptime(l) 

du(l) 

quota(l) 

teach jove(l) 

what(l) 

intro(7) 

csh(l) 

talk(l) 

write(l) 

setuid(3) 

talkd(8C) 

environ(7) 

whoami(l) 

»u(l) 

getuid(2) 

setreuid(2) 

finger(l) 

telnet(lC) 

getuid(3F) 

edquota(8) 

adduser(8) 

binmail(l) 

wall(l) 

whodos(l) 

last(l) 

users(l) 

getlog(3F) 

users(l) 

getrusage(2) 

vtimes(3C) 

utime(3C) 

utimes(2) 

utmp(5) 

uuclean(8C) 

rmail(l) 

uuclean(8C) 

uusnap(8C) 

uucp(lC) 

uuencode(lC) 

uuencode(S) 

uuencode(o) 

uuencode(lC) 

uucp(lC) 

uusend(lC) 

uusnap(8C) 

uux(lC) 

uxrc(8) 

valloc(3) 

abs(3) 

floor(3M) 

getenv(3) 

readlink(2) 

getenv(3F) 

getitimer(2) 

csh(l) 

false(l) 

flmin(3F) 

rand(3F) 

true(l) 

byteorder(3n) 

varargs(3) 

csh(l) 

varargs(3) 

csh(l) 
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arithmetic on shell variables...csb(l) 

asset: discard shell variables...esh(l) 

unsetenv: remove environment variables. ... csh(l) 

getenv: get value ot environment variables...getenv(3F) 

to create and display iaformatioa for MPS/DOS vdisks. dosdisk: program .dosdisk(8) 

assert: program verification. *.assert(3X) 

lint: a C program verifier....iint(l) 

vers: print version number of the kernel. ....... vers(l) 

expand, unexpand: expand tabs to spaces, and vice versa.... ..expand(l) 

trman: translate version 6 manual macros to version 7 macros. • • • . • trman(l) 

trman: translate version 6 manual macros to version 7 macros. ..trman(l) 

vers: print version number of the kernel. •••••••••••• vers(l) 

hangman: Computer version of the game hangman.*.hangman(6) 

file, what: show what versions of object modules were used to construct a ... what(l) 

efficient way. vfork: Bpawn new process in a virtual memory • • • • • Yfork(2) 

vgrind: grind nice listings of programs.vgrind(l) 

vgrindefs: vgrind’s language definition data base.vgrindefs(5) 

vgrindefs: vgrind’s language definition data base. •••••••• vgrindefs(5) 

terminal, vhangup: virtually “hangup” the current control • • • • vhangup(2) 

on ex. vi: screen oriented (visual) display editor based • • . • • vi(l) 

encode/decode a binary file for transmission via mail. uuencode,uudecode: •••••••••••• uuencode(lC) 

rmail: handle remote mail received via uucp. • ....rmail(l) 

expand, unexpand: expand tabs to spaces, and vice versa. ....... .expand(l) 

more, page: file perusal filter for crt viewing.... more(l) 

robots: fight off villainous robots. ..robots(6) 

vipw: edit the password file. ..yipw(8) 

dosdisks: list of MPS/DOS virtual disks. ..dosdisks(S) 

vfork: spawn new process in a virtual memory efficient way. ... vfork(2) 

vmstat: report virtual memory statistics. ••••• vmstat(l) 

vhangup: virtually “hangup” the current control terminal.vbangup(2) 

vi: screen oriented (visual) display editor based on ex. ..vi(l) 

consumption, vlimit: control maximum system resource ..vlimit(3C) 

vmstat: report virtual memory statistics. ••••••• vmstat(l) 

fs, inode: format of file system volume. ... fs(5) 

vtimes: get information about resource utilisation. • • • vtimes(3C) 

w: who is on and what they are doing.w(l) 

wait: await completion of process. • ... wait(l) 

read, readonly, set, shift, times, trap, umask, wait: command language, /exec, exit, export, login, . . . sh(l) 

wait: wait for a process to terminate. • • • • *.wait(3F) 

wait: wait for background processes to complete. .csh(l) 

sigpause: atomically release blocked signals and wait for interrupt...sigpause(2) 

wait, wait3: wait for process to terminate.. wait(2) 

wait: wait for a process to terminate. wait(3F) 

wait: wait for background processes to complete.csh(l) 

wait, wait3: wait for process to terminate. wait(2) 

wait, wait3: wait for process to terminate.wait(2) 

wall: write to all users. . ..wali(l) 

wc: word count...wc(l) 

what: show what versions of object modules were used to construct a file. ••••• .. what(l) 

whatis: describe what a command is.. whatis(l) 

crash: what happens when the system crashes, .crash(BV) 

used to construct a file, what: show what versions of object modules were .... what(l) 

w: who is on and what they are doing.... • • • w(l) 

construct a file, what: show what versions of object modules were used to .what(l) 

whatis: describe what a command is. • • • ..whatis(l) 

crash: what happens when the system crashes. ... crash(8V) 

leave: remind you when you have to leave.. leave(l) 

program, whereis: locate source, binary, and or manual for .... whereisfl) 
paths (cek only), which: locate a program file including aliases and • • • • which(l) 

exec, exit, export, login,/ sh, for, case, if, while, s , • , break, continue, cd, eval, • ..sh(l) 

while: repeat commands conditionally.csh(l) 

break: exit while/foreach loop. •••••• csh(l) 

users: compact list of users who are on the system. .users(l) 

from: who is my mail from?. . from(l) 

w: who is on and what they are doing. •••••••••• w(l) 

who: who is on the system. ... who(l) 

biff: be notified if mail arrives and who it is from.....biff(l) 

who: who is on the system.. who(l) 

whoami: print effective current user id.. whoami(l) 

whodos: display information about dose users.. whodos(l) 

rwho: who’s logged in on local machines.rwho(lC) 

fold: fold long lines for finite width output device.. • • • fold(l) 

window: window environment...window(l) 

window: window environment. ••••• .window(l) 

fastboot, fasthalt: reboot/halt the system without checking the disks.. fastboot(8) 
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Permuted Index 


we: word count. ... wc(l) 

getc, getchar, fgetc, getw: get character or word from stream. .* getc(3S) 

putc, putebar, fputc, putw: put character or word on a stream.. ... putc(3S) 

diction,explain: print wordy sentences; thesaurus for diction. • • ..diction(l) 

explain, diction- print wordy sentences; thesaurus for diction. •••••••• explain(l) 

cd: change working directory...cd(l) 

chdir: change current working directory.chdir(2) 

getewd: get pathname of current working directory. .getcwd(3F) 

pwd: working directory name...pwd(l) 

getwd: get current working directory pathname. getwd(3) 

worm: Play the growing worm game...worm(6) 

worm: Play the growing worm game.. • • . worm(6) 

worms: animate worms on a display terminal. • . • • • worms(6) 

worms: animate worms on a display terminal.. . worms(6) 

putc, fputc: write a character to a fortran logical unit.putc(3F) 

write, writev: write on a file. ... write(2) 

wall: write to all users. ..... wall(l) 

write: write to another user. . . . ... writefl) 

write: write to another user...write(l) 

write, writev: write on a file.write(2) 

write, writev: write on a file....write(2) 

open: open a file for reading or writing, or create a new file.open(2) 

utmp, wtmp: login records.. ..utmp(5) 

wump: the game of huntrthe-wumpus.wump(6) 

xsend, xget, enroll: secret mail. .. xsend(l) 

bit: and, or, xor, not, rshift, Ishift bitwise functions.bit(3F) 

xsend, xget, enroll: secret mail.xsend(l) 

shared strings, xstr: extract strings from C programs to implement • . • xstr(l) 

jO, jl, jn, yO, yl, yn: bessel functions.jO(3M) 

jO, jl, jn, yO, yl, yn: bessel functions. .jO(3M) 

eyacc: modified yacc allowing much improved error recovery.eyacc(l) 

yacc: yet another compiler-compiler.yacc(l) 

yes: be repetitively affirmative.. . . yes(l) 

jO, jl, jn, yO, yl, yn: bessel functions. ....jO(3M) 

compress, uncompress, zcat: compress and expand data.compress(l) 

PP dstrules: Daylight savings time and time zone name rule file.. ..dstrules(5) 
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INTRODUCTION TO VOLUME 1 


INTRODUCTION 

This volume gives descriptions of the publicly available features of the ICON/UXB 
operating system, as extended to provide a virtual memory environment and other 
enhancements. It does not attempt to provide perspective or tutorial information upon 
the ICON/UXB operating system, its facilities, or its implementation. Various docu¬ 
ments on those topics are contained in Volumes 2 and 3, Supplementary Documentation. 
In particular, for an overview see The UNIX* Time-Sharing System by Ritchie and 
Thompson; for a tutorial see UNIX* for Beginners by Kernighan. 

Within the area it surveys, this volume attempts to be timely, complete and concise. 
Where the latter two objectives conflict, the obvious is often left unsaid in favor of 
brevity. It is intended that each program be described as it is, not as it should be. 
Inevitably, this means that various sections will soon be out of date. As changes are 
made, updates will be forthcoming. 

This volume is divided into eight sections: 

1. Commands 

2. System Calls 

3. Subroutines 

4. Special Files 

5. File Formats and Conventions 

6. Games 

7. Miscellaneous 

8. Maintenance Commands and Procedures 

Commands are programs intended to be invoked directly by the user, in contradistinc¬ 
tion to subroutines, which are intended to be called by the user’s programs. Commands 
generally reside in directory /bin (for 6tnary programs). Some programs also reside in 
/usr/bin, or in /usr/ucb, to save space in /bin. These directories are searched 
automatically by the command interpreters. 

System Calls are entries into the ICON/UXB supervisor. The system call interface is 
identical to a C language procedure call; the equivalent C procedures are described in 
Section 2. 

Ail assortment of Subroutines is available; they are described in section 3. The pri¬ 
mary libraries in which they are kept are described in the introduction to section 3, 
tnfro(3). The functions are described in terms of C, but most will work with Fortran as 
well. 

UNIX is a registered trademark of AT&T 
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The Special Files section discusses the characteristics of each system ‘file’ that actu¬ 
ally refers to an I/O device. The names in this section refer to the ICON 
MultiMicro/MainFrame Architecture device names for the hardware, instead of the 
names of the special files themselves. 

The File Formats and Conventions section documents the structure of particular 
kinds of files; for example, the form of the output of the loader and assembler is given. 
Excluded are files used by only one command, for example the assembler’s intermediate 
files. 

Games have been relegated to section 6 to keep them from contaminating the more 
staid information of section 1. 

Section 7 is a Miscellaneous collection of information necessary to writing in various 
specialized languages: character codes, macro packages for typesetting, etc. 

The Maintenance section discusses commands and procedures not intended for use by 
the ordinary user. The commands and files described in Section 8 are almost all kept in 
the directory I etc. 

SECTION FORMAT 

Each section in the ICON/UXB Reference Manual consists of a number of independent 
entries of one or more pages each. The name of the entry is in the upper corners of its 
pages, together with the section number, and sometimes a letter characteristic of a sub¬ 
category, e.g. graphics is 1G, and the math library is 3M. Entries within each section 
are alphabetized. The page numbers of each entry start at 1; it is infeasible to number 
consecutively the pages of a document like this that is republished in many variant 
forms and is constantly being changed, updated, or obsoleted. 

All entries are based on a common format, not all of whose subsections will always 
appear. 

The NAME subsection lists the exact names of the commands and subroutines covered 
under the entry and gives a very short description of their purpose. 

The SYNOPSIS summarizes the use of the program being described. A few conventions 
are used, particularly in the Commands subsection: - 

• Boldface words are considered literals, and are typed just as they appear. 

• Square brackets [ ] around an argument indicate that the argument is 

optional. When an argument is given as ‘name’, it always refers to a file 

name. 

• Ellipses ..’ are used to show that the previous argument-prototype may be 
repeated. 

• A final convention is used by the commands themselves. An argument begin¬ 
ning with a minus sign ( — ) is often taken to mean some sort of option- 
specifying argument even if it appears in a position where a file name could 
appear. Therefore, it is unwise to have files whose names begin with 
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The DESCRIPTION subsection discusses in detail the subject at hand. 

The FILES subsection gives the names of files which are built into the program. 

A SEE ALSO subsection gives pointers to related information. 

A DIAGNOSTICS subsection discusses the diagnostic indications which may be pro¬ 
duced. Messages which are intended to be self-explanatory are not listed. 

The BUGS subsection gives known bugs and sometimes deficiencies. Occasionally also 
the suggested fix is described. 

At the beginning of the volume is a table of contents, organized by section and alpha¬ 
betically within each section. There is also a permuted index derived from the table of 
contents. Within each index entry, the title of the writeup to which it refers is followed 
by the appropriate section number in parentheses. This fact is important because there 
is considerable name duplication among the sections, arising principally from commands 
which exist only to exercise a particular system call. 

HOW TO GET STARTED 

This section sketches the basic information you need to get started on the ICON/UXB 
operating system; how to log in and log out, how to communicate through your termi¬ 
nal, and how to run a program. See UNIX • for Beginners in Volume 2 for a more com¬ 
plete introduction to the system. 

Logging In 

You must call ICON/UXB from an appropriate terminal. Almost any ASCII terminal 
capable of full duplex operation and generating the entire character set can be used. 
You must also have a valid user name, which may be obtained, together with necessary 
telephone numbers, from the system administration. After a data connection is esta¬ 
blished, the login procedure depends on what kind of terminal you are using and local 
system conventions. The following examples are typical. 

800-baud terminals: Such terminals include the GE Terminet 300, and most display 
terminals run with popular modems. These terminals generally have a speed switch 
which should be set at ‘300’ (or ‘30’ for 30 characters per second) and a half/full duplex 
switch which should be set at full-duplex. (This switch will often have to be changed 
since many other systems require half-duplex). When a connection is established, the 
system types login: you type your user name, followed by the ‘return’ key. If you have 
a password, the system asks for it and turns off the printer on the terminal so the pass¬ 
word will not appear. After you have logged in, the ‘return’, ‘new line’, or ‘linefeed’ 
keys will give exactly the same results. 

1200- and 150-baud terminals: If there is a half/full duplex switch, set it at full-duplex. 
When you have established a data connection, the system types out a few' garbage char¬ 
acters (the login: message at the wrong speed). Depress the ‘break’ (or ‘interrupt’) key; 
this is a speed-independent signal to the ICON/UXB operating system that a different 
speed terminal is in use. The system then will type login: this time at another speed. 
Continue depressing the break key until login: appears in clear, then respond with your 
user name. From the TTY 37 terminal, and any other which has the ‘newline’ function 
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(combined carriage return and linefeed), terminate each line you type with the ‘new 
line’ key, otherwise use the ‘return’ key. 

Hard-wired terminals. Hard-wired terminals usually begin at the right speed, up to 
9600 baud; otherwise the preceding instructions apply. 

For all these terminals, it is important that you type your name in lower-case if possi¬ 
ble; if you type upper-case letters, ICON/UXB will assume that your terminal cannot 
generate lower-case letters and will translate all subsequent upper-case letters to lower 
case. 

The evidence that you have successfully logged in is that a shell program will type a 
prompt (either a ‘$’ or a depending on the shell program activated) to you. (The 
shells are described below under How to Run a Program — the Shells.) 

For more information, consult tset{ 1), and s/fy(l), which tell how to adjust terminal 
behavior, getty(8), which discusses the login sequence in more detail, and tty(4), which 
discusses terminal I/O. 

Logging Out 

Logging out is a process where the active shell is terminated and all files accessed by 
the logged in user are saved to the system hard disk. This process maintains the 
integrity and security of the ICON/UXB file system. 

There are three ways to log out of the ICON/UXB operating system: 

• By typing an end-of-text indicator (EOT character, control-d, shown as d) 
to the shell. The shell will terminate and the login: message will appear 
again. 

• You can type logout, if you are using the C shell. The shell will terminate 
and return the login: prompt. (If you have several shells active, youmust 
enter the exit command to terminate the active shell until the actual login 
shell is reached.) 

• You can login directly as yourself or another user by entering the login com¬ 
mand. (See login (1).) 

If you are communicating over a phone line, and worse comes to worse, you can simply 
hang up the phone; but beware — some machines may lack the necessary hardware to 
detect that the phone has been hung up. Ask your system administrator if this is a 
problem on your machine. (NOTE: Turning off your terminal, however, does not log 
you off the system. You must still use the control-d key sequence, or enter logout, or 
login to terminate the login shell.) 

HOW TO COMMUNICATE THROUGH YOUR TERMINAL 

When you type characters, a gnome deep in the system gathers your characters and 
saves them in a secret place. The characters will not be given to a program until you 
type a return (or newline), as described above in Logging In. 

ICON/UXB terminal I/O is full-duplex. It has full read-ahead, which means that you 
can type at any time, even while a program is typing at you. Of course, if you type 


4 


ICON INTERNATIONAL 



(luring output, the printed output will have the input characters interspersed. How¬ 
ever, whatever you type will be saved up and interpreted in correct sequence. There is 
a limit to the amount of read-ahead, but it is generous and not likely to be exceeded 
unless the system is in trouble. When the read-ahead limit is exceeded, the system 
throws away all the saved characters (or beeps, if your prompt was a %). 

The character in typed input kills all the preceding characters in the line, so typing 
mistakes can be repaired on a single line. Also, the character *#’ erases the last char¬ 
acter typed. (Most users prefer to use a backspace rather than and many prefer 
control-U instead of ‘@*; tset( 1) or stty( 1) can be used to arrange this.) Successive uses 
of ‘#’ erase characters back to, but not beyond, the beginning of the line. and *#’ 
can be transmitted to a program by preceding them with *\\ (So, to erase ‘\’, you need 
two ‘#’s). 

The ‘break’ or ‘interrupt’ key causes an interrupt signal, as does the ASCII ‘delete’ (or 
‘rubout’) character, which is not passed to programs. This signal generally causes 
whatever program you are running to terminate. It is typically used to stop a long 
printout that you don’t want. However, programs can arrange either to ignore this sig¬ 
nal altogether, or to be notified when it happens (instead of being terminated). The edi¬ 
tor, for example, catches interrupts and stops what it is doing, instead of terminating, 
so that an interrupt can be used to halt an editor printout without losing the file being 
edited. Many users change this interrupt character to be "C (control-C) using stty{ 1). 

It is also possible to suspend output temporarily using ~S (control-s) and later resume 
output with "Q. In a newer terminal driver, it is possible to cause output to be thrown 
away without interrupting the program by typing "O; see tty( 4). 

The quit signal is generated by typing the ASCII FS character. (FS appears many places 
on different terminals, most commonly as control-\ or control-].) It not only causes a 
running program to terminate but also generates a file with the core image of the ter¬ 
minated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, ICON/UXB tries to be intelligent about 
whether you have a terminal with the newline function or whether it must be simulated 
with carriage-return and line-feed. In the latter case, all input carriage returns are 
turned to newline characters (the standard line delimiter) and both a carriage return 
and a line feed are echoed to the terminal. If you get into the wrong mode, the reset( 1) 
command will rescue you. 

Tab characters are used freely in ICON/UXB source programs. If your terminal does 
not have the tab function, you can arrange to have them turned into spaces during out¬ 
put, and echoed as spaces during input. The system assumes that tabs are set every 
eight columns. Again, the tset{\) or s«y(l) command will set or reset this mode. 
Tset( 1) can be used to set the tab stops automatically when necessary. 

HOW TO RUN A PROGRAM — THE SHELLS 

When you have successfully logged in, a program called a Shell is listening to your ter¬ 
minal. The shell reads typed-in lines, splits them up into a command name and argu¬ 
ments, and executes the command. A command is simply an executable program. The 
shell looks in several system directories to find the command. You can also place com¬ 
mands in your own directory and have the shell find them there. There is nothing 
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special about system-provided commands except that they are kept in a directory 
where the shell can find them. 

The command name is always the first word on an input line; it and its arguments are 
separated from one another by spaces. 

When a program terminates, the shell will ordinarily regain control and type a prompt 
at you to indicate that it is ready for another command. 

The shells have many other capabilities, which are described in detail in sections sfi(l) 
and csfi(l). If the shell prompts you with then it is an instance of sh(l) the stan¬ 
dard Bell-Labs provided shell. If it prompts with l %' then it is an instance of csh( 1), a 
shell written at U.C. Berkeley. The shells are different for all but the most simple ter¬ 
minal usage. Most users at Berkeley choose c«A(l) because of the history mechanism 
and the alias feature, which greatly enhance its power when used interactively. The 
Berkeley csh also supports the job-control facilities. Refer to c«A(l) or the Introduction 
to the C Shell in Volume 2 for details. 

You can change from one shell to the other by using the chsh( 1) command, which takes 
effect at your next login. 

THE CURRENT DIRECTORY 

ICON/UXB has a file system arranged in a hierarchy of directories. When the system 
administrator gave you a user name, he also created a directory for you (ordinarily 
with the same name as your user name). When you log in, any file name you type is by 
default in this directory. Since you are the owner of this directory, you have full per¬ 
mission to read, write, alter, or destroy its contents. Permissions to have your will with 
other directories and files will have been granted or denied to you by their owners. As 
a matter of observed fact, few ICON/UXB users protect their files from perusal by 
other users. 

To change the current directory (but not the set of permissions you were endowed with 
at login) use cd(l). 

PATH NAMES 

To refer to files not in the current directory, you must use a path name. Full path 
names begin with */’, the name of the root directory of the whole file system. After the 
slash comes the name of each directory containing the next sub-directory (followed by a 
‘/’) until finally the file name is reached. For example, /usrflemffilex refers to the file 
filex in the directory lem; lem is itself a subdirectory of usr; usr springs directly from 
the root directory /. 

If your current directory has subdirectories, the path names of files therein begin with 
the name of the subdirectory with no prefixed '/’• 

A path name may be used anywhere a file name is required. 

Important commands which modify the contents of files are cp(l), mr(l), and rm(l), 
which respectively copy, move (i.e. rename) and remove files. To find out the status of 
files or directories, use /s(l). See mkdir(l ) for making directories and rmdir (in rm(l)) 
for destroying them. 
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For a fuller discussion of the file system, see The UNIX 9 Time-Sharing System, by Ken 
Thompson and Dennis Ritchie in Volume 2. It may also be useful to glance through 
Section 2 of this manual, which discusses system calls, even if you don’t intend to deal 
with the system at that level. 

WRITING AN ICON/UXB PROGRAM 

To enter the text of a source program into an ICON/UXB file, use the editor ex(l) or 
its display editing alias tn(l). (The old standard editor ed(l) is also available.) The 
principal languages in ICON/UXB are provided by the C compiler cc(l), the Fortran 
compiler /77(l), the Pascal compiler pc(l), and interpreter pi(l) and px( 1), and the Lisp 
system iisp(l). User contributed software in the latest release of the system supports 
APL, the Functional Programming language, and Icon. Refer to ap/(l), fp( 1), and 
*con(l), respectively for more information about each. After the program text has been 
entered through the editor and written on a file, you can give the file to the appropriate 
language processor as an argument. The output of the language processor will be left 
on a file in the current directory named ‘a.out’. (If the output is precious, use mv to 
move it to a less exposed name soon.) 

When you have finally gone through this entire process without provoking any diagnos¬ 
tics, the resulting program can be run by giving its name to the shell in response to the 
shell ('$’ or ‘%’) prompt. 

Your programs can receive arguments from the command line just as system programs 
do. Refer to the exect;e(2) command. 

TEXT PROCESSING 

Almost all text is entered through the editor ex(l) or its display-oriented counterpart vi 
(I). The commands most often used to write text on a terminal are: cat, pr, more and 
nroff, all described in section 1. 

The cat command simply dumps ASCII text on the terminal, with no processing at all. 
The pr command paginates the text, supplies headings, and has a facility for multi- 
column output. 

nroff is an elaborate text formatting program. Used naked, it requires careful 
forethought, but for ordinary documents it has been tamed; see me( 7) and ms(7). 

troff prepares documents for a Graphics Systems phototypesetter or a Versatec Plotter; 
it is very similar to nroff, and often works from exactly the same source text. It was 
used to produce this manual. 

script(l) lets you keep a record of your session in a file, which can then be printed, 
mailed, etc. It provides the advantages of a hard-copy terminal even when using a 
display terminal. 

more(l) is useful for preventing the output of a command from zipping off the top of 
your screen. It is also well suited to perusing files. 
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STATUS INQUIRIES 


Various commands exist to provide you with useful information. u>(l) prints a list of 
users presently logged in, and what they are doing. date( 1) prints the current time and 
date. ls( 1) will list the files in your directory or give summary information about par¬ 
ticular files. 

SURPRISES 

Certain commands provide inter-user communication. Even if you do not plan to use 
them, it would be well to learn something about them, because someone else may aim 
them at you. 

To communicate with another user currently logged in, write(l) is used; ma»7(l) will 
leave a message whose presence will be announced to another user when he next logs in. 
The write-ups in the manual also suggest how to respond to the two commands if you 
are a target. 

If you use csh( I) the key 'Z (control-Z) will cause jobs to stop. If this happens before 
you learn about it, you can simply continue by entering fg (for foreground) to bring the 
job back. 

When you log in, a message-of-the-day may greet you before the first prompt. Be 
patient, especially if the message is long. Your shell prompt will eventually appear nad 
you can go to work. 

OTHER MANUALS AND BOOKS ON THE UNIX® OPERATING SYSTEM 

To assist you in learning more about the UNIX operating system, the following is a 
recommended list of some excellent books and manuals for novice users of the UNIX® 
operating system. These are also invaluable resources and references for experienced 
UNIX® operating system users. 

• UNIX Primer Plus, Waite, Martin, and Prata, 

Howard W. Sams, 1983 

• Understanding UNIX, A Conceptual Guide, Groff and Weinberg, 

Que Corp., 1983 

• Exploring the UNIX System, Kochan and Wood, 

Hayden Book, 1983 

• A User Guide to the UNIX System, Thomas and Yates, 

Osborne/McGraw-Hill, 1985 

• UNIX Programmer’s Manual, Volumes 1 and 2, Bell Labs, AT&T, 

Holt, Rinehart and Winston, 1983 

• Introducing the UNIX System, McGilton and Morgan, 

McGraw-Hill, 1983 

• Starting With UNIX, Brown, 

Addison-Wesley, 1984 

• The UNIX Programming Environment, Kernighan and Pike, 

Prentice-Hall, 1984 
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INTRO (1) 


USER COMMANDS 


INTRO (1) 


NAME 

intro - introduction to commands 

* 

DESCRIPTION 

This section describes publicly accessible commands in alphabetic order. Certain distinctions 
of purpose are made in the headings: 

(l) Commands of general utility. 

(1C) Commands for communication with other systems. 

(1G) Commands used primarily for graphics and computer-aided design. 

N.B.: Commands related to system maintenance used to appear in section 1 manual pages and 
were distinguished by (1M) at the top of the page. These manual pages now appear in section 
8 . 

SEE ALSO 

Section (6) for computer games. 

How to get started, in the Introduction. 

DIAGNOSTICS 

Upon termination each command returns two bytes of status, one supplied by the system giv¬ 
ing the cause for termination, and (in the case of ‘normal’ termination) one supplied by the 
program, see wait and exit( 2). The former byte is 0 for normal termination, the latter is cus¬ 
tomarily 0 for successful execution, nonzero to indicate troubles such as erroneous parameters, 
bad or inaccessible data, or other inability to cope with the task at hand. It is called vari¬ 
ously ‘exit code’, ‘exit status’ or ‘return code’, and is described only where special conventions 
are involved. 
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ADB(l) 


USER COMMANDS 


ADB(l) 


NAME 

adb - debugger 

SYNOPSIS 

adb [-w] [ -k ] [ -d ] [ -Idir ] [ objfil [ corfil ] j 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used to examine files and to provide 
a controlled environment for the execution of UNIX programs. 

Objfil is normally an executable program file, preferably containing a symbol table; if not then 
the symbolic features of adb cannot be used although the file can still be examined. The 
default for objfil is a.out. Corfil is assumed to be a core image file produced after executing 
objfil; the default for corfil is core. 

Requests to adb are read from the standard input and responses are to the standard output. 
If the -w flag is present then both objfil and corfil are created if necessary and opened for 
reading and writing so that files can be modified using adb. 

The —k option allows adb to examine the running UNIX kernel. This option, on the ICON 
machines, selects the main-side division of UNIX, for disk-side operation, see the -d option. If 
this option is selected, objfil must be the directory (with an appended ’/’) where the running 
kernel resides, and corfil must be present and set to / dev/kmem. 

The — d option allows adb to examine the running disk cache processor’s instruction/data 
space. If this option is selected, objfil must be the directory (with an appended ’/’) where the 
disk cache kernel resides, and corfil must be present and set to /dev/dmem. 

The -I option specifies a directory where files to be read with $< or $< < (see below) will be 
sought; the default is / usr / lib / adb. 

Adb ignores QUIT; INTERRUPT causes return to the next adb command. 

In' general requests to adb are of the form 

[ address ] [, count] [command] [;] 

If address is present then dot is set to address. Initially dot is set to 0. For most commands 
count specifies how many times the command will be executed. The default count is 1. 
Address and count are expressions. 

The interpretation of an address depends on the context it is used in. If a subprocess is being 
debugged then addresses are interpreted in the usual way in the address space of the subpro¬ 
cess. If the operating system is being debugged, using the special file /dev/kmem to interac¬ 
tive examine and/or modify memory, the maps are set to map the kernel addresses which 
start at 0x40000000. see ADDRESSES. 

EXPRESSIONS 

. The value of dot. 

+ The value of dot incremented by the current increment. 

The value of dot decremented by the current increment. 

The last address typed. 

integer A number. The prefixes Oo and OO (“zero oh”) force interpretation in octal radix; the 
prefixes Ot and 0T force interpretation in decimal radix; the prefixes Ox and OX force 
interpretation in hexadecimal radix. Thus 0o20 = 0tl6 = 0x10 — sixteen. If no 
prefix appears, then the default radix is used; see the $d command. The default radix 
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is initially hexadecimal. The hexadecimal digits are 0123456789abcdefABCDEF with 
the obvious values. Note that a hexadecimal number whose most significant digit 
would otherwise be an alphabetic character must have a Ox (or OX) prefix (or a lead¬ 
ing zero if the default radix is hexadecimal). 

integer .fraction 

A 32 bit floating point number. 

'cccc ' The ASCII value of up to 4 characters. \ may be used to escape a '. 

< name 

The value of name, which is either a variable name or a register name. Adb main¬ 
tains a number of variables (see VARIABLES) named by single letters or digits. If name 
is a register name then the value of the register is obtained from the system header in 
corfil. The register names are those printed by the $r command. 

symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not start¬ 
ing with a digit. The backslash character \ may be used to escape other characters. 
The value of the symbol is taken from the symbol table in objfil. An initial _ will be 
prepended to symbol if needed. 

_ symbol 

In C, the ‘true name’ of an external symbol begins with _. It may be necessary to 

utter this name to distinguish it from internal or hidden variables of a program. 

(exp ) The value of the expression exp. 

Monadic operators 

*exp The contents of the location addressed by exp in corfil. 

@exp The contents of the location addressed by exp in objfil. 

-exp Integer negation. 

~ exp Bitwise complement. 

#exp Logical negation. 

Dyadic operators are left associative and are less binding than monadic operators. 

el+e2 Integer addition. 

el-e2 Integer subtraction. 

el*e2 Integer multiplication. 

el%e2 Integer division. 

el8ce2 Bitwise conjunction. 

el\e2 Bitwise disjunction. 

elfje2 El rounded up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of modifiers. The following 
verbs are available. (The commands '?’ and ‘/’ may be followed by see ADDRESSES, for 
further details.) 

?/ Locations starting at address in objfil are printed according to the format /. dot is 
incremented by the sum of the increments for each format letter (q.v.). 

// Locations starting at address in corfil are printed according to the format / and dot is 
incremented as for T. 
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—/ The value of address itself is printed in the styles indicated by the format /. (For i 

format*?’ is printed for the parts of the instruction that reference subsequent words.) 

A format consists of one or more characters that specify a style of printing. Each format 
character may be preceded by a decimal integer that is a repeat count for the format charac¬ 
ter. While stepping through a format dot is incremented by the amount given for each format 
letter. If no format is given then the last format is used. The format letters available are as 
follows. 


o 2 
O 4 
q 2 
Q4 
d 2 
D 4 
x 2 
X 4 
u 2 
U 4 
f 4 
F 8 
b 1 
c 1 
C 1 

s n 
S n 

Y 4 
i n 


a 0 


/ 

? 


P 4 

t 0 

r 0 
n 0 

0 


+ 


Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 

Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the standard escape convention where con¬ 
trol characters are printed as "X and the delete character is printed as "?. 

Print the addressed characters until a zero character is reached. 

Print a string using the * X escape convention (see C above), n is the length of 
the string including its zero terminator. 

Print 4 bytes in date format (see ctime{ 3)). 

Print as machine instructions, n is the number of bytes occupied by the 
instruction. This style of printing causes variables 1 and 2 to be set to the 
offset parts of the source and destination respectively. 

Print the value of dot in symbolic form. Symbols are checked to ensure that 
they have an appropriate type as indicated below. 

local or global data symbol 
local or global text symbol 
local or global absolute symbol 

Print the addressed value in symbolic form using the same rules for symbol 
lookup as a. 

When preceded by an integer tabs to the next appropriate tab stop. For exam¬ 
ple, 8t moves to the next 8-space tab stop. 

Print a space. 

Print a newline. 

Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

Dot is incremented by 1. Nothing is printed. 

Dot is decremented by 1. Nothing is printed. 


newline 

Repeat the previous command with a count of 1. 


[?/]l value mask 

Words starting at dot are masked with mask and compared with value until a match is 
found. If L is used then the match is for 4 bytes at a time instead of 2. If no match 
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is found then dot is unchanged; otherwise dot is set to the matched location. If mask is 
omitted then -1 is used. 

[?/]w value ... 

Write the 2-byte value into the addressed location. If the command is W, write 4 
bytes. Odd addresses are not allowed when writing to the subprocess address space. 

[?/]m bl el fl[T/] 

New values for (bl, el, fl) are recorded. If less than three expressions are given then 
the remaining map parameters are left unchanged. If the ‘V or ‘/’ is followed by V 
then the second segment ( b£,e2,f2 ) of the mapping is changed. If the list is ter¬ 
minated by '?’ or 7’ then the file ( objfil or corfil respectively) is used for subsequent 
requests. (So that, for example, l /mV will cause l /' to refer to objfil.) see ADDRESSES 

>name 

Dot is assigned to the variable or register named. 

! A shell (/bin/sh) is called to read the rest of the line following M’. 

%modifier 

Miscellaneous commands. The available modifiers are: 

</ Read commands from the file /. If this command is executed in a file, further 
commands in the file are not seen. If /is omitted, the current input stream is 
terminated. If a count is given, and is zero, the command will be ignored. The 
value of the count will be placed in variable 9 before the first command in / is 
executed. 

< </ Similar to < except it can be used in a file of commands without causing the 
file to be closed. Variable 9 is saved during the execution of this command, 
and restored when it completes. There is a (small) finite limit to the number of 
<< files that can be open at once. 

>/ Append output to the file /, which is created if it does not exist. If / is omit¬ 
ted, output is returned to the terminal. 

? Print process id, the signal which caused stoppage or termination, as well as 

the registers as $r. This is the default if modifier is omitted, 
r Print the general registers and the instruction addressed by pc. Dot is set to 

pc. 

F If there is an MC68881 floating point coprocessor, print the value in each regis¬ 
ter, in double format. 

b Print all breakpoints and their associated counts and commands. 

D Delete all breakpoints and their associated counts and commands, 
c C stack backtrace. If address is given then it is taken as the address of the 
current frame instead of the contents of the frame-pointer register. If C is 
used then the names and (32 bit) values of all automatic and static variables 
are printed for each active function, (broken on the VAX). If count is given 
then only the first count frames are printed. 

d Set the default radix to address and report the new value. Note that address is 
interpreted in the (old) current radix. Thus “10$d” never changes the default 
radix. To make decimal the default radix, use “OtlO$d”. 
e The names and values of external variables are printed, 
w Set the page width for output to address (default 80). 

s Set the limit for symbol matches to address (default 255). 

o All integers input are regarded as octal, 
q Exit from adb. 

v Print all non zero variables in octal, 
m Print the address map. 
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p (Kernel debugging) Change the current kernel memory mapping to map the 

designated user structure to the address given by the symbol _u. The address 
argument is the address of the user’s user page table entries (on the VAX). 

:modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address. The breakpoint is executed count- 1 times before 
causing a stop. Each time the breakpoint is encountered the command c is 
executed. If this command is omitted or sets dot to zero then the breakpoint 
causes a stop. 

d Delete breakpoint at address. 

r Run objfil as a subprocess. If address is given explicitly then the program is 
entered at this point; otherwise the program is entered at its standard entry 
point, count specifies how many breakpoints are to be ignored before stopping. 
Arguments to the subprocess may be supplied on the same line as the com¬ 
mand. An argument starting with < or > causes the standard input or out¬ 
put to be established for the command. 

cs The subprocess is continued with signal s, see sigvec( 2). If address is given 
then the subprocess is continued at this address. If no signal is specified then 
the signal that caused the subprocess to stop is sent. Breakpoint skipping is 
the same as for r. 

ss As for c except that the subprocess is single stepped count times. If there is no 
current subprocess then objfil is run as a subprocess as for r. In this case no 
signal can be sent; the remainder of the line is treated as arguments to the sub- 
process. 

n Stops at the next address after the present one. If the next instruction is any 
kind of jsr, a breakpoint is set at the instruction after it, and the process is 
continued, otherwise a single step is taken. Jmp’s and bee’s are followed. 

u Looks at the current call frame for the return address, sets a breakpoint at 
that address, then continues the process, thus popping you back up the call 
tree. Because it looks at the current call frame, if the up command is used 

before the link instruction is executed, you will be popped up two call levels. 

k The current subprocess, if any, is terminated. 

VARIABLES 

Adb provides a number of variables. Named variables are set initially by adb but are not used 

subsequently. Numbered variables are reserved for communication as follows. 

0 The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

9 The count on the last $< or $<< command. 


On entry the following are set from the system header in the corfil. If corfil does not appear 
to be a core file then these values are set from objfil. 

b The base address of the data segment, 
d The data segment size, 

e The entry point. 

m The ‘magic’ number (0407, 0410 or 0413). 
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s The stack segment size, 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is determined by a mapping associated 
with that file. Each mapping is represented by two triples ( bl, el, fl) and ( bS, e2, f2 ) and the 
file address corresponding to a written address is calculated as follows. 

bl<address<el => file address=addres$+fl-bl, otherwise, 

b2<address<e2 => file address=address+/2-b2, 

otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I 
and D space) the two segments for a file may overlap. If a ? or / is followed by an * then 
only the second triple is used. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file 
is not of the kind expected then, for that file, bl is set to 0, el is set to the maximum file size 
and fl is set to 0; in this way the whole file can be examined with no address translation. 

FILES 

a.out 

core 

SEE ALSO 

cc(l), dbx(l), ptrace(2), a.out(5), core(5) 

DIAGNOSTICS 

‘Adb’ when there is no current command or format. Comments about inaccessible files, syn¬ 
tax errors, abnormal termination of commands, etc. Exit status is 0, unless last command 
failed or returned nonzero status. 

NOTES 

The only commands that make any sense in kernel mode are those for displaying and chang¬ 
ing data. Printing backtrace and registers, setting and displaying breakpoints, and process 
manipulations do not work. Data and instruction space are not really differentiated. On the 
main side, because addresses under 0x40000000 are in user space, and nothing can be 
guaranteed about their contents, from moment to moment, 0x40000000 is the lowest address 
readable in /dev/kmem. This is a property of /dev/kmem, not adb. Obviously only those for 
whom /dev/kmem has write permission turned on may change anything in the running ker¬ 
nel. 

In most cases it is difficult to change floating point variables. If the integer equivalents (what¬ 
ever the radix is) for the floating point number is known, they may be written with the /w 
command. 

A variant syntax is used to simplify writing to the floating point registers on the floating 
point coprocessor. Rather than: 

value >regn 

as is used to write data and address registers, the following syntax is used (fvalue = floating 
point format): 

>fpn fvalue 
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Setuid and setgid programs do not run correctly under adb because ptrace inhibits the setuid 
and setgid mechanism. This is to enhance system security. 


BUGS 

Since no shell is invoked to interpret the arguments of the :r command, the customary wild¬ 
card and variable expansions cannot occur. 

Because of the manner in which the current C compiler pushes parameters on the stack, there 
is no way to differentiate between subroutines with one parameter, and those with none. 
Thus we always assume one parameter. 
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NAME 

addbib - create or extend bibliographic database 

SYNOPSIS 

addbib [ —p promptfile ] [ — a ] database 

DESCRIPTION 

When this program starts up, answering “y” to the initial “Instructions?” prompt yields 
directions; typing “n” or RETURN skips them. Addbib then prompts for various bibliographic 
fields, reads responses from the terminal, and sends output records to a database. A null 
response (just RETURN) means to leave out that field. A minus sign (-) means to go back to 
the previous field. A trailing backslash allows a field to be continued on the next line. The 
repeating “Continue?” prompt allows the user either to resume by typing “y” or RETURN, to 
quit the current session by typing “n” or “q”, or to edit the database with any system editor 
(vi, ex, edit, ed). 

The —a option suppresses prompting for an abstract; asking for an abstract is the default. 
Abstracts are ended with a CTRL-d. The -p option causes addbib to use a new prompting 
skeleton, defined in promptfile. This file should contain prompt strings, a tab, and the key- 
letters to be written to the database. 

The most common key-letters and their meanings are given below. Addbib insulates you from 
these key-letters, since it gives you prompts in English, but if you edit the bibliography file 
later on, you will need to know this information. 

%A Author’s name 

%B Book containing article referenced 

%C City (place of publication) 

%D Date of publication 

%E Editor of book containing article referenced 
%F Footnote number or label (supplied by refer) 

%G Government order number 

%H Header commentary, printed before reference 

%\ Issuer (publisher) 

%J Journal containing article 

%K Keywords to use in locating reference 

%L Label field used by —k option of refer 
%M Bell Labs Memorandum (undefined) 

%N Number within volume 

%0 Other commentary, printed at end of reference 
%P Page number(s) 

%Q Corporate or Foreign Author (unreversed) 

%R Report, paper, or thesis (unpublished) 

%S Series title 

%T Title of article or book 

%V Volume number 

%X Abstract — used by roffbib, not by refer 

%Y,Z ignored by refer 

Except for ‘A’, each field should be given just once. Only relevant fields should be supplied. 
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An example is: 

%A Bill Tnthill 

%T Refer — A Bibliography System 

%l Computing Services 

%C Berkeley 
%D 1982 
%Q UNX 4.3.5. 


FILES 

promptfile optional file to define prompting 
SEE ALSO 

refer(l), sortbib(l), roffbib(l), indxbib(l), lookbib(l) 

AUTHORS 

A1 Stangenberger, Bill Tuthill 
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NAME 

apply - apply a command to a set of arguments 

SYNOPSIS 

apply [ —ac ] [ —n ] command args ... 

DESCRIPTION 

Apply runs the named command on each argument arg in turn. Normally arguments are 
chosen singly; the optional number n specifies the number of arguments to be passed to com¬ 
mand. If n is zero, command is run without arguments once for each arg. Character sequences 
of the form %d in command, where d is a digit from 1 to 9, are replaced by the d’th following 
unused arg. If any such sequences occur, n is ignored, and the number of arguments passed to 
command is the maximum value of d in command. The character may be changed by the 
—a option. 

Examples: 

apply echo * 
is similar to ls(l); 

apply -2 cmp al bl a2 b2 ... 
compares the ‘a’ files to the ‘b’ files; 

apply -0 who 1 2 3 4 5 
runs who(l) 5 times; and 

apply 'In %l /usr/joe' * 

links all files in the current directory to the directory /usr/joe. 

SEE ALSO 

sh(l) 

AUTHOR 

Rob Pike 


BUGS 

Shell metacharacters in command may have bizarre effects; it is best to enclose complicated 
commands in single quotes ' '. 

There is no way to pass a literal ‘%2’ if ‘%’ is the argument expansion character. 
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NAME 

apropos - locate commands by keyword lookup 

SYNOPSIS 

apropos keyword ... 

DESCRIPTION 

Apropos shows which manual sections contain instances of any of the given keywords in their 
title. Each word is considered separately and case of letters is ignored. Words which are part 
of other words are considered thus looking for compile will hit all instances of ‘compiler’ also. 
Try 

apropos password 

and 

apropos editor 

If the line starts ‘name(section) ...’ you can do ‘man section name’ to get the documentation 
for it. Try ‘apropos format’ and then ‘man 3s printf’ to get the manual on the subroutine 
printf. 

Apropos is actually just the -k option to the man(l) command. 


FILES 

/usr/lib/whatis data base. 

SEE ALSO 

man(l), whatis(l), catman(8) 

AUTHOR 

William Joy 
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NAME 

ar - archive and library maintainer 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and 
update library files as used by the loader. It can be used, though, for any similar purpose. 
N.B: This version of ar uses a ASCII-format archive which is portable among the various 
machines running UNIX. Programs for dealing with older formats are available: see arct>(8). 

Key is one character from the set drqtpmx, optionally concatenated with one or more of 
vuaibclo. Afile is the archive file. The names are constituent files in the archive file. The 
meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used with r, 
then only those files with ‘last-modified’ dates later than the archive files are replaced. 
If an optional positioning character from the set abi is used, then the posname argu¬ 
ment must be present and specifies that new files are to be placed after (a) or before 
(b or i) posname. Otherwise new files are placed at the end. 

q Quickly append the named files to the end of the archive file. Optional positioning 
characters are invalid. The command does not check whether the added members are 
already in the archive. Useful only to avoid quadratic behavior when creating a large 
archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the 
archive are tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is present, 
then the posname argument must be present and, as in r, specifies where the files are 
to be moved. 

x Extract the named files. If no names are given, all files in the archive are extracted. 
In neither case does x alter the archive file. Normally the ‘last-modified’ date of each 
extracted file is the date when it is extracted. However, if o is used, the ‘last-modified’ 
date is reset to the date recorded in the archive. 

v Verbose. Under the verbose option, ar gives a file-by-file description of the making of 
a new archive file from the old archive and the constituent files. When used with t, it 
gives a long listing of all information about the files. When used with p, it precedes 
each file with a name. 

c Create. Normally ar will create afile when it needs to. The create option suppresses 
the normal message that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the directory /tmp. This option 
causes them to be placed in the local directory. 

FILES 

/tmp/v* temporaries 
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SEE ALSO 

lorder(l), ld(l), ranlib(l), ar(5), arcv(8) 


BUGS 

If the same file is mentioned twice in an argument list, it may be put in the archive twice. 

The ‘last-modified’ date of a file will not be altered by the o option if the user is not the 
owner of the extracted file, or the super-user. 
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NAME 

as - M68020 assembler 

SYNOPSIS 

as [ —o objfile ] [ name ... ] 

DESCRIPTION 

As assembles the named files. 

The output of the assembly is left on the file objfile; if that is omitted, name.o is used. 


FILES 

/tmp/as* default temporary files 

a.out default resultant object file 

SEE ALSO 

Id(l), nm(l), adb(l), dbx(l), a.out.(5) 

Auxiliary documentation Assembler Reference Manual. 
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NAME 

at - execute commands at a later time 

SYNOPSIS 

at time [ day ] [ file ] 

DESCRIPTION 

At squirrels away a copy of the named file (standard input default) to be used as input to 
sh( 1) (or csh( 1) if you normally use it) at a specified later time. A cd command to the current 
directory is inserted at the beginning, followed by assignments to all environment variables 
(excepting the variable TERM, which is useless in this context.) When the script is run, it uses 
the user and group ID of the creator of the copy file. 

The time is 1 to 4 digits, with an optional following ‘A’, ‘P’, ‘N’ or ‘M’ for AM, PM, noon or 
midnight. One and two digit numbers are taken to be hours, three and four digits to be 
hours and minutes. If no letters follow the digits, a 24 hour clock time is understood. 

The optional day is either (1) a month name followed by a day number, or (2) a day of the 
week; if the word ‘week’ follows invocation is moved seven days further off. Names of months 
and days may be recognizably truncated. Examples of legitimate commands are 

at 8am jan 24 
at 1530 fr week 

At programs are executed by periodic execution of the command /usr/lib/atrun from cron(8). 
The granularity of at depends upon how often atrun is executed. 

Standard output or error output is lost unless redirected. 


FILES 

/usr/lib/atrun 

in /usr/spool/at: 

yy.ddd.hhhh.* 

lasttimedone 

past 


executor (run by cron(8)). 


activity for year yy, day dd, hour hhhh. 
last hhhh 

activities in progress 


SEE ALSO 

calendar(l), pwd(l), sleep(l), cron(8) 

DIAGNOSTICS 

Complains about various syntax errors and times out of range. 


BUGS 

Due to the granularity of the execution of /usr/lib/atrun, there may be bugs in scheduling 
things almost exactly 24 hours into the future. 
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NAME 

awk - pattern scanning and processing language 

SYNOPSIS 

awk [ -Fc ] [ prog ] [ file ] ... 

DESCRIPTION 

Awk scans each input file for lines that match any of a set of patterns specified in prog. With 
each pattern in prog there can be an associated action that will be performed when a line of a 
file matches the pattern. The set of patterns may appear literally as prog, or in a file specified 
as —f file. 

Files are read in order; if there are no files, the standard input is read. The file name 
means the standard input. Each line is matched against the pattern portion of every 
pattern-action statement; the associated action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default can be changed by 
using FS, vide infra.) The fields are denoted $1, $2, ... ; $0 refers to the entire line. 

A pattern-action statement has the form 
pattern { action } 

A missing { action } means print the line; a missing pattern always matches. 

An action is a sequence of statements. A statement can be one of the following: 

if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list. ] [ >expression ] 

next #skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, newlines or right braces. An empty expression-list 
stands for the whole line. Expressions take on string or numeric values as appropriate, and 
are built using the operators +, *, /, %, and concatenation (indicated by a blank). The C 

operators ++, —, +=, *=, /=, and %— are also available in expressions. Variables 

may be scalars, array elements (denoted x[i]) or fields. Variables are initialized to the null 
string. Array subscripts may be any string, not necessarily numeric; this allows for a form of 
associative memory. String constants are quoted 

The print statement prints its arguments on the standard output (or on a file if >file is 
present), separated by the current output field separator, and terminated by the output 
record separator. The printf statement formats its expression list according to the format (see 
printfi 3S)). 

The built-in function length returns the length of its argument taken as a string, or of the 
whole line if no argument. There are also built-in functions exp, log, sqrt , and int. The last 
truncates its argument to an integer. substr(s, m, n) returns the n-character substring of s 
that begins at position m. The function sprintfffmt, expr, expr, ...) formats the expressions 
according to the printf(3 S) format given by fmt and returns the resulting string. 
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Patterns are arbitrary Boolean combinations (!, ||, &&, and parentheses) of regular expressions 
and relational expressions. Regular expressions must be surrounded by slashes and are as in 
egrep. Isolated regular expressions in a pattern apply to the entire line. Regular expressions 
may also occur in relational expressions. 

A pattern may consist of two patterns separated by a comma; in this case, the action is per¬ 
formed for all lines between an occurrence of the first pattern and the next occurrence of the 
second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either ~ (for con¬ 
tains) or !~ (for does not contain). A conditional is an arithmetic expression, a relational 
expression, or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control before the first input 
line is read and after the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by starting the program with 
BEGIN { FS = V } 
or by using the —Fc option. 

Other variable names with special meanings include NF, the number of fields in the current 
record; NR, the ordinal number of the current record; FILENAME, the name of the current 
input file; OFS, the output field separator (default blank); ORS, the output record separator 
(default newline); and OFMT, the output format for numbers (default "%.6g"). 

EXAMPLES 

Print lines longer than 72 characters: 
length >72 

Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; —i) print $i } 

Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 


SEE ALSO 

lex(l), sed(l) 

A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk - a pattern scanning and processing 
language 
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BUGS 

There are no explicit conversions between numbers and strings. To force an expression to be 
treated as a number add 0 to it; to force it to be treated as a string concatenate "" to it. 
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NAME 

basename - strip filename affixes 

SYNOPSIS 

basename string [ suffix ] 

DESCRIPTION 

Basename deletes any prefix ending in */’ and the suffix, if present in string, from string, and 
prints the result on the standard output. It is normally used inside substitution marks ' ' in 
shell procedures. 

This shell procedure invoked with the argument / usr/src/bin/cat.c compiles the named file 
and moves the output to cat in the current directory: 

cc $1 

mv a.out 'basename $1 .c' 

SEE ALSO 

sh(l) 
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NAME 

be - arbitrary-precision arithmetic language 

SYNOPSIS 

be [ — c ] [ — 1 ] [ file ... ] 

DESCRIPTION 

Be is an interactive processor for a language which resembles C but provides unlimited preci¬ 
sion arithmetic. It takes input from any files given, then reads the standard input. The -1 
argument stands for the name of an arbitrary precision math library. The syntax for be pro¬ 
grams is as follows; L means letter a-z, E means expression, S means statement. 

Comments 

are enclosed in /* and */• 

Names 

simple variables: L 
array elements: L [ E ] 

The w'ords ‘ibase’, ‘obase’, and ‘scale’ 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 

sqrt ( E ) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L ( E , , E ) 

Operators 

+ -*/%" {% is remainder; " is power) 

+4- — (prefix and postfix; apply to names) 

Statements 

E 

{ s ; ; S } 

if ( E ) S 
while ( E ) S 
for ( E ; E ; E ) S 
null statement 
break 
quit 

Function definitions 

define L ( L ,..., L ) { 
auto L, ... , L 
S; ... S 
return ( E ) 

} 

Functions in -1 math library 


s(x) 

sine 

c(x) 

cosine 

e(x) 

exponential 

l(x) 

log 
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a(x) 

arctangent 


( j 

j(n,x) 

Bessel function 


vy 

All function arguments are passed by value. 




The value of a statement that is an expression is printed unless the main operator is an 
assignment. Either semicolons or newlines may separate statements. Assignment to scale 
influences the number of digits to be retained on arithmetic operations in the manner of dc(l). 
Assignments to ibase or obase set the input and output number radix respectively. 

The same letter may be used as an array, a function, and a simple variable simultaneously. 
All variables are global to the program. ‘Auto’ variables are pushed down during function 
calls. When using arrays as function arguments or defining them as automatic variables 
empty square brackets must follow the array name. 

For example 

scale = 20 
define e(x){ 

auto a, b, c, i, s 
a =1 

b = 1 
s = 1 

for(i=l; 1==1; i++){ 
a = a*x 
b = b*i 
c — a/b 

if(c === 0) return(s) 
s = s+c 

} 

} 

defines a function to compute an approximate value of the exponential function and 
for(i=l; i<=10; i-f-f) e(i) 

prints approximate values of the exponential function of the first ten integers. 

Be is actually a preprocessor for dc{ 1), which it invokes automatically, unless the —c (compile 
only) option is present. In this case the dc input is sent to the standard output instead. 

FILES 

/usr/lib/lib.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 

dc w 

L. L. Cherry and R. Morris, BC -An arbitrary precision desk-calculator language 


BUGS 

No &.&, | L or ! operators. 

For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 


2 


ICON INTERNATIONAL 



BIFF (1) 


USER COMMANDS 


BIFF (1) 


. NAME 

biff - be notified if mail arrives and who it is from 

SYNOPSIS 

biff [ yn ] 

DESCRIPTION 

Biff informs the system whether you want to be notified when mail arrives during the current 
terminal session. The command 

biff y 

enables notification; the command 

biff n 

disables it. When mail notification is enabled, the header and first few lines of the message 
will be printed on your screen whenever mail arrives. A “biff y” command is often included in 
the file .login or .profile to be executed at each login. 

Biff operates asynchronously. For synchronous notification use the MAIL variable of s/?(l) or 
the mail variable of csh( 1). 

SEE ALSO 

csh(l), sh(l), mail(l), comsat(8C) 
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NAME 

binmail - send or receive mail among users 

SYNOPSIS 

/bin/mail [+ 1 [ —i 1 [ person ] ... 

/bin/mail [ + ] } — i j —f file 

DESCRIPTION 

Note: This is the old version 7 UNIX system mail program. The default mail command is 
described in Mail(l), and its binary is in the directory /usr/ucb. 

mail with no argument prints a user’s mail, message-by-message, in last-in, first-out order; the 
optional argument 4- displays the mail messages in first-in, first-out order. For each message, 
it reads a line from the standard input to direct disposition of the message. 

newline 

Go on to next message, 
d Delete message and go on to the next, 
p Print message again. 

- Go back to previous message, 

s [ file ] ... 

Save the message in the named files (‘inbox’ default), 
w [file] ... 

Save the message, without a header, in the named files (‘mbox’ default), 
m [ person ] ... 

Mail the message to the named persons (yourself is default). 

EOT (control-D) 

Put unexamined mail back in the mailbox and stop, 
q Same as EOT. 

! command 

Escape to the Shell to do command. 

* Print a command summary. 

An interrupt normally terminates the mail command; the mail file is unchanged. The 
optional argument —i tells mail to continue after interrupts. 

When persons are named, mail takes the standard input up to an end-of-file (or a line with 
just ‘.’) and adds it to each person’s ‘mail’ file. The message is preceded by the sender’s name 
and a postmark. Lines that look like postmarks are prepended with *>’. A person is usually 
a user name recognized by login{l). To denote a recipient on a remote system, prefix person 
by the system name and exclamation mark (see uucp(lC)). 

The —f option causes the named file, for example, ‘mbox’, to be printed as if it were the mail 
file. 

When a user logs in he is informed of the presence of mail. 
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FILES 

/etc/passwd 
/usr / spool/mail/* 
mbox 
/tmp/ma* 

/usr/ spool/m ail/*, lock 
dead.letter 


to identify sender and locate persons 
incoming mail for user * 
saved mail 
temp file 

lock for mail directory 
unmailable text 


SEE ALSO 

Mail(l), write(l), uucp(lC), uux(lC), xsend(l), sendmail(8) 


BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

Normally anybody can read your mail, unless it is sent by xsend( 1). An installation can over¬ 
come this by making mail a set-user-id command that owns the mail directory. 
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NAME 

cal - print calendar 

SYNOPSIS 

cal [ month ] year 

DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, a calendar just for 
that month is printed. Year can be between 1 and 9999. The month is a number between 1 
and 12. The calendar produced is that for England and her colonies. 

Try September 1752. 


BUGS 

The year is always considered to start in January even though this is historically naive. 
Beware that ‘cal 78’ refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

Calendar consults the file ‘calendar’ in the current directory and prints out lines that contain 
today’s or tomorrow’s date anywhere in the line. Most reasonable month-day dates such as 
‘Dec. 7,’ ‘december 7,’ ‘12/7,’ etc., are recognized, but not ‘7 December’ or ‘7/12’. If you give 
the month as with a date, i.e. “* 1”, that day in any month will do. On weekends 
‘tomorrow’ extends through Monday. 

When an argument is present, calendar does its job for every user who has a file ‘calendar' in 
his login directory and sends him any positive results by mat7(l). Normally this is done daily 
in the wee hours under control of cron( 8). 

The file ‘calendar’ is first run through the “C” preprocessor, /lib/cpp, to include any other 
calendar files specified with the usual “#include” syntax. Included calendars will usually be 
shared by all users, maintained and documented by the local administration. 


FILES 

calendar 

/usr/lib/calendar to figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

/lib/cpp, egrep, sed, mail as subprocesses 

SEE ALSO 

at.(l), cron(8), mail(l) 


BUGS 

Calendar’s extended idea of ‘tomorrow’ doesn’t account for holidays. 
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NAME 


cat - catenate and print 





SYNOPSIS 

cat [ -u ] [ — n ] [ —s ] [ -v ] file ... 

DESCRIPTION 

Cat reads each file in sequence and displays it on the standard output. Thus 
cat file 

displays the file on the standard output, and 
cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument is encountered, cat reads from the standard 
input file. Output is buffered in 1024-byte blocks unless the standard output is a terminal, in 
which case it is line buffered. The —u option makes the output completely unbuffered. 

The —n option displays the output lines preceded by lines numbers, numbered sequentially 
from 1. Specifying the -b option with the — n option omits the line numbers from blank lines. 

The -s option crushes out multiple adjacent empty lines so that the output is displayed single 
spaced. 

The —v option displays non-printing characters so that they are visible. Control characters 
print like "X for control-x; the delete character (octal 0177) prints as "?. Non-ascii characters 
(with the high bit set) are printed as M- (for meta) followed by the character of the low 7 
bits. A —e option may be given with the -v option, which displays a ‘$’ character at the end 
of each line. Specifying the -t option with the -v option displays tab characters as 'I. 

SEE ALSO 

cp(l), ex(l), more(l), pr(l), tail(l) 


BUGS 

Beware of ‘cat a b >a’ and ‘cat a b >b’, which destroy the input files before reading them. 


f'"' 
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NAME 

cb - C program beautifier 

SYNOPSIS 
cb . 

DESCRIPTION 

Cb places a copy of the C program from the standard input on the standard output with 
spacing and indentation that displays the structure of the program. 
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NAME 

cc - C compiler 


SYNOPSIS 

cc [ option ] ... file ... 


DESCRIPTION 

Cc is the UNIX C compiler. Cc accepts several types of arguments: 

Arguments whose names end with ‘.c’ are taken to be C source programs; they are compiled, 
and each object program is left on the file whose name is that of the source with ‘.o’ substi¬ 
tuted for ‘.c’. The ‘.o’ file is normally deleted, however, if a single C program is compiled and 
loaded all at one go. 

In the same way, arguments whose names end with ‘.s’ are taken to be assembly source pro¬ 
grams and are assembled, producing a ‘.o’ file. 

The following options are interpreted by cc. See ld( 1) for load-time options. 

—c Suppress the loading phase of the compilation, and force an object file to be pro¬ 

duced even if only one program is compiled. 

—f Compiles floating point operations to use the MC68881 floating point coprocessor. 

Also switches to versions of libc.a and /usr/lib/libm.a that use the floating point 
chip. Setting the environment variable FP to m68881 has the same effect as speci¬ 
fying this flag. Code generated with this option will cause an "Illegal instruction" 
trap when executed on machines that do not have the floating point coprocessor chip 
installed. 


—g Have the compiler produce additional symbol table information for dbx{ 1). Also pass 
the —lg flag to ld( 1). 

—w Suppress warning diagnostics. 

—p Arrange for the compiler to produce code which counts the number of times each 
routine is called. If loading takes place, replace the standard startup routine by one 
which automatically calls monitor{3) at the start and arranges to write out a 
mon.out file at normal termination of execution of the object program. An execution 
profile can then be generated by use of prof(l). 

—pg Causes the compiler to produce counting code in the manner of —p, but invokes a 

run-time recording mechanism that keeps more extensive statistics and produces a 
gmon.out file at normal termination. Also, a profiling library is searched, in lieu of 
the standard C library. An execution profile can then be generated by use of 
9 ProJ{ 1). 

-O Invoke an object-code improver. 

-R Passed on to as, making initialized variables shared and read-only. 

-S Compile the named C programs, and leave the assembler-language output on 
corresponding files suffixed ‘.s’. 

-E Run only the macro preprocessor on the named C programs, and send the result to 
the standard output. 

-C prevent the macro preprocessor from eliding comments. 

-# Debug flag. Prints the phases (including arguments) of the compiler that would be 
executed if this flag was not present. 
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—o output 

Name the final output file output. If this option is used the file ‘a.out’ will be left 
undisturbed. 

-D name—def 

-D name Define the name to the preprocessor, as if by ‘^define’. If no definition is given, the 
name is defined as "1". 

-U name Remove any initial definition of name. 

-I dir ‘^include’ files whose names do not begin with */’ are always sought first in the 
directory of the file argument, then in directories named in —I options, then in direc¬ 
tories on a standard list. 

Other arguments are taken to be either loader option arguments, or C-compatible object pro¬ 
grams, typically produced by an earlier cc run, or perhaps libraries of C-compatible routines. 
These programs, together with the results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name &.out. 


FILES 

file.c input file 

file.o object file 

a.out loaded output 

/tmp/ctm? temporary 

/lib/cpp preprocessor 

/lib/cO pass 1 of the compiler 

/lib/cl pass 2 of the compiler 

/lib/c2 optional optimizer 

/lib/crtO.o runtime startoff 

/lib/mcrtO.o startoff for profiling 

/usr/lib/gcrtO.o startoff for gprof-profiling 

/lib/libc.a standard library, see intro{ 3) 

/usr/lib/libc_p.a profiling library, see intro{ 3) 

/usr/include standard directory for ‘#include’ files 
mon.out file produced for analysis by pro/(l) 
gmon.out file produced for analysis by gprof(l) 

SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
B. W. Kernighan, Programming in C—a tutorial 
D. M. Ritchie, C Reference Manual 
monitor(3), prof(l), gprof(l), adb(l), ld(l), dbx(l), as(l) 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. 
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NAME 

cd - change working directory 

SYNOPSIS 

cd directory 

DESCRIPTION 

Directory becomes the new working directory. The process must have execute (search) permis¬ 
sion in directory. 

Because a new process is created to execute each command, cd would be ineffective if it were 
written as a normal command. It is therefore recognized and executed by the shells. In cs/j(1) 
you may specify a list of directories in which directory is to be sought as a subdirectory if it is 
not a subdirectory of the current directory; see the description of the cdpath variable in cs/t(l). 

SEE ALSO 

csh(l), sh(l), pwd(l), chdir(2) 


ICON INTERNATIONAL 


1 



CHECKNR (1) 


USER COMMANDS 


CHECKNR (1) 


NAME 

check nr - check nroff/troff files 
SYNOPSIS 

checknr [ — s ] [ —f ] [ -a.xl.yl.x2.y2.xn.yn ] [ -c.xl.x2.x3 ... .xn ] [ file ... ] 

DESCRIPTION 

Checknr checks a list of nrojfi 1) or troffil) input files for certain kinds of errors involving 
mismatched opening and closing delimiters and unknown commands. If no files are specified, 
checknr checks the standard input. Delimeters checked are: 

(1) Font changes using \fx ... \fP. 

(2) Size changes using \sx ... \s0. 

(3) Macros that come in open ... close forms, for example, the .TS and .TE macros which 
must always come in pairs. 

Checknr knows about the ms( 7) and me(7) macro packages. 

Additional pairs of macros can be added to the list using the -a option. This must be fol¬ 
lowed by groups of six characters, each group defining a pair of macros. The six characters 
are a period, the first macro name, another period, and the second macro name. For example, 
to define a pair .BS and .ES, use -a.BS.ES 

The —c option defines commands which would otherwise be complained about as undefined. 
The -f option requests checknr to ignore \f font changes. 

The -s option requests checknr to ignore \s size changes. 

Checknr is intended to be used on documents that are prepared with checknr in mind, much 
the same as lint. It expects a certain document writing style for \f and \s commands, in that 
each \fx must be terminated with \fP and each \sx must be terminated with \s0. While it 
will work to directly go into the next font or explicitly specify the original font or point size, 
and many existing documents actually do this, such a practice will produce complaints from 
checknr. Since it is probably better to use the \fP and \s0 forms anyway, you should think of 
this as a contribution to your document preparation style. 

SEE ALSO 

nroff(l), troff(l), checkeq(l), ms(7), me(7) 

DIAGNOSTICS 

Complaints about unmatched delimiters. 

Complaints about unrecognized commands. 

Various complaints about the syntax of commands. 

AUTHOR 

Mark Horton 


BUGS 

There is no way to define a 1 character macro name using -a. 

Does not correctly recognize certain reasonable constructs, such as conditionals. 
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NAME 

chfn - change finger entry 

SYNOPSIS 

chfn [loginname] 

DESCRIPTION 

Chfn is used to change information about users. This information is used by the finger pro¬ 
gram, among others. It consists of the user’s "real life" name, office room number, office phone 
number, and home phone number. Chfn prompts the user for each field. Included in the 
prompt is a default value, which is enclosed between brackets. The default value is accepted 
simply by typing <return>. To enter a blank field, type the word ’none’. Below is a sample 
run: 

Name [Biff Studsworth II]: 

Room number (Exs: 597E or 197C) []: 521E 

Office Phone (Ex: 1632) []: 1863 

Home Phone (Ex: 987532) [5771546]: none 

Chfn allows phone numbers to be entered with or without hyphens. Because finger only 
knows about UCB extensions, chfn will insist upon a four digit number (after the hyphens are 
removed) for office phone numbers. Also, room numbers must be in Evans or Cory; again, 
this is because of finger. 

It is a good idea to run finger after running chfn to make sure everything is the way you want 
it. 

The optional argument loginname is used to change another person’s finger information. 
This can only be done by the super-user. 


FILES 

/etc/passwd, /etc/ptmp 

SEE ALSO 

finger(l), passwd(5) 


BUGS 

The encoding of the office and extension information is installation dependent. 

For historical reasons, the user’s name, etc are stored in the passwd file. This is a bad place 
to store the information. Rumors are that a data base is being developed to store this infor¬ 
mation, but don’t hold your breath. 

Because two users may try to write the passwd file at once, a synchronization method was 
developed. On rare occasions, a message that the password file is "busy" w r ill be printed. In 
this case, chfn sleeps for a while and then tries to write to the passwd file again. 
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NAME 

chgrp - change group 

SYNOPSIS 

chgrp [ -f ] group file ... 

DESCRIPTION 

Chgrp changes the group-ID of the files to group. The group may be either a decimal GID or 
a group name found in the group-ID file. 

The user invoking chgrp must belong to the specified group and be the owner of the file, or be 
the super-user. 

No errors are reported w'hen the -f (force) option is given. 


FILES 

/etc/group 

SEE ALSO 

chow r n(2), passwd(5), group(5) 
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NAME 




chmod - change mode 





SYNOPSIS 

chmod mode file ... 

DESCRIPTION 

The mode of each named file is changed according to mode, which may be absolute or sym¬ 
bolic. An absolute mode is an octal number constructed from the OR of the following modes: 

4000 set user ID on execution 
2000 set group ID on execution 
1000 sticky bit, see chmod( 2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[tc/io] op permission [op permission] ... 

The who part is a combination of the letters u (for user’s permissions), g (group) and o 
(other). The letter a stands for all, or ugo. If who is omitted, the default is a but the setting 
of the file creation mask (see umask(2)) is taken into account. 

Op can be + to add permission to the file’s mode, - to take away permission and = to assign 
permission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or 
group id) and t (save text - sticky). Letters u, g or o indicate that permission is to be taken 
from the current mode. Omitting permission is only useful with = to take away all permis¬ 
sions. 

EXAMPLES 

The first example denies write permission to others, the second makes a file executable: 

chmod o-w file 
chmod +x file 

Multiple symbolic modes separated by commas may be given. Operations are performed in 
the order specified. The letter s is only useful with u or g. 

Only the owner of a file (or the super-user) may change its mode. 

NOTE 

Currently all programs behave as if the sticky bit were set. But in the future this may have 
some functionality. 

SEE ALSO 

ls(l), chmod(2), stat(2), umask(2), chown(8) 
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NAME 

chsh - change default login shell 

SYNOPSIS 

chsh name [ shell ] 

DESCRIPTION 

Chsh is a command similar to passwd(l) except that it is used to change the login shell field of 
the password file rather than the password entry. If no shell is specified then the shell reverts 
to the default login shell /bin/sh. Otherwise only /bin/csh, /bin/oldcsh, or /usr/new/csh can 
be specified as the shell unless you are the super-user. 

An example use of this command would be 
chsh bill /bin/csh 

SEE ALSO 

csh(l), passwd(l), passwd(5) 
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NAME 

ci — check in RCS revisions 

SYNOPSIS 

ci [ options ] file ... 

DESCRIPTION 

Ci stores new revisions into RCS files. Each file name ending in *,v’ is taken to be an RCS 
file, all others are assumed to be working files containing new revisions. Ci deposits the con¬ 
tents of each working file into the corresponding RCS file. 

Pairs of RCS files and working files may be specified in 3 ways (see also the example section 
of co (1)). 

1) Both the RCS file and the working file are given. The RCS file name is of the form 
pathl / workfile, v and the working file name is of the form paths/workfile, where pathl / and 
paths/ are (possibly different or empty) paths and workfile is a file name. 

2) Only the RCS file is given. Then the working file is assumed to be in the current directory 
and its name is derived from the name of the RCS file by removing pathl/ and the suffix ‘,v\ 

3) Only the working file is given. Then the name of the RCS file is derived from the name of 
the working file by removing paths/ and appending the suffix ‘,v’. 

If the RCS file is omitted or specified without a path, then ci looks for the RCS file first in 
the directory ./RCS and then in the current directory. 

For ci to work, the caller’s login must be on the access list, except if the access list is empty 
or the caller is the superuser or the owner of the file. To append a new revision to an exist¬ 
ing branch, the tip revision on that branch must be locked by the caller. Otherwise, only a 
new branch can be created. This restriction is not enforced for the owner of the file, unless 
locking is set to strict (see res (1)). A lock held by someone else may be broken with the res 
command. 

Normally, ci checks whether the revision to be deposited is different from the preceding one. 
If it is not different, ci either aborts the deposit (if -q is given) or asks whether to abort (if -q 
is omitted). A deposit can be forced with the -f option. 

For each revision deposited, ci prompts for a log message. The log message should summar¬ 
ize the change and must be terminated with a line containing a single V or a control-D. If 
several files are checked in, ci asks whether to reuse the previous log message. If the std. 
input is not a terminal, ci suppresses the prompt and uses the same log message for all files. 
See also -m. 

The number of the deposited revision can be given by any of the options -r, -f, -k, -1, -u, or 
-q (see -r). 

If the RCS file does not exist, ci creates it and deposits the contents of the working file as 
the initial revision (default number: 1.1). The access list is initialized to empty. Instead of 
the log message, ci requests descriptive text (see -t below). 

—r[rev] assigns the revision number rev to the checked-in revision, releases the 

corresponding lock, and deletes the working file. This is also the default. 

If rev is omitted, ci derives the new revision number from the caller’s last lock. If 
the caller has locked the tip revision of a branch, the new revision is appended to 
that branch. The new revision number is obtained by incrementing the tip revi¬ 
sion number. If the caller locked a non-tip revision, a new branch is started at 
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that revision by incrementing the highest branch number at that revision. The 
default initial branch and level numbers are 1. If the caller holds no lock, but he 
is the owner of the file and locking is not set to strict, then the revision is 
appended to the trunk. 

If rev indicates a revision number, it must be higher than the latest one on the 
branch to which rev belongs, or must start a new branch. 

If ret; indicates a branch instead of a revision, the new revision is appended to 
that branch. The level number is obtained by incrementing the tip revision 
number of that branch. If ret; indicates a non-existing branch, that branch is 
created with the initial revision numbered rev.l. 


—t[rev\ 
—k [rev] 


—l[reu] 


—u[reu] 

—q[ret;] 

—m msg 
—nname 

—N name 
—s state 

—t[txtfile] 


Exception: On the trunk, revisions can be appended to the end, but not inserted. 

forces a deposit; the new revision is deposited even it is not different from the 
preceding one. 

searches the working file for keyword values to determine its revision number, 
creation date, author, and state (see co (1)), and assigns these values to the depo¬ 
sited revision, rather than computing them locally. A revision number given by a 
command option overrides the number in the working file. This option is useful 
for software distribution. A revision that is sent to several sites should be 
checked in with the -k option at these sites to preserve its original number, date, 
author, and state. 

works like -r, except it performs an additional co -l for the deposited revision. 
Thus, the deposited revision is immediately checked out again and locked. This 
is useful for saving a revision although one wants to continue editing it after the 
checkin. 

works like -1, except that the deposited revision is not locked. This is useful if 
one wants to process (e.g., compile) the revision immediately after checkin. 

quiet mode; diagnostic output is not printed. A revision that is not different from 
the preceding one is not deposited, unless -f is given. 

uses the string msg as the log message for all revisions checked in. 

assigns the symbolic name name to the number of the checked-in revision. Ci 
prints an error message if name is already assigned to another number. 

same as -n, except that it overrides a previous assignment of name. 

sets the state of the checked-in revision to the identifier state. The default is 
Exp. 

writes descriptive text into the RCS file (deletes the existing text). If txtfile is 
omitted, ci prompts the user for text supplied from the std. input, terminated 
with a line containing a single V or control-D. Otherwise, the descriptive text is 
copied from the file txtfile. During initialization, descriptive text is requested 
even if -t is not given. The prompt is suppressed if std. input is not a terminal. 


DIAGNOSTICS 

For each revision, ci prints the RCS file, the working file, and the number of both the depo¬ 
sited and the preceding revision. The exit status always refers to the last file checked in, 
and is 0 if the operation was successful, 1 otherwise. 
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FILE MODES 

An RCS file created by ci inherits the read and execute permissions from the working file. If 
the RCS file exists already, ci preserves its read and execute permissions. Ci always turns off 
all write permissions of RCS files. 


FILES 

The caller of the command must have read/write permission for the directories containing 
the RCS file and the working file, and read permission for the RCS file itself. A number of 
temporary files are created. A semaphore file is created in the directory containing the RCS 
file. Ci always creates a new RCS file and unlinks the old one. This strategy makes links to 
RCS files useless. 

IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 3.1 ; Release Date: 83/04/04 . 

Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

co (1), ident(l), res (1), resdiff (l), rcsintro (l), resmerge (1), rlog (1), resfile (5), sccstorcs (8). 
Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 


BUGS 
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NAME 

clear - clear terminal screen 

SYNOPSIS 

clear 


DESCRIPTION 

Clear clears your screen if this is possible. It looks in the environment for the terminal type 
and then in /etc/termcap to figure out how to clear the screen. 


FILES 

/etc/termcap terminal capability data base 
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NAME 

cmp - compare two files 

SYNOPSIS 

cmp [ — 1 ] [ —s ] filel file2 
DESCRIPTION 

The two files are compared. (If filel is the standard input is used.) Under default options, 
cmp makes no comment if the files are the same; if they differ, it announces the byte and line 
number at which the difference occurred. If one file is an initial subsequence of the other, that 
fact is noted. 

Options: 

—1 Print the byte number (decimal) and the differing bytes (octal) for each difference. 

—s Print nothing for differing files; return codes only. 


SEE ALSO 

diff(l), comm(l) 


DIAGNOSTICS 

Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or miss¬ 
ing argument. 
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NAME 

co — check out RCS revisions 

SYNOPSIS 

co [ options ] file ... 

DESCRIPTION 

Co retrieves revisions from RCS files. Each file name ending in ‘,v’ is taken to be an RCS 
file. All other files are assumed to be working files. Co retrieves a revision from each RCS 
file and stores it into the corresponding working file. 

Pairs of RCS files and working files may be specified in 3 ways (see also the example section). 

1) Both the RCS file and the working file are given. The RCS file name is of the form 
pathl/workfile,\ and the working file name is of the form paths/workfile, where pathl/ and 
path2f are (possibly different or empty) paths and workfile is a file name. 

2) Only the RCS file is given. Then the working file is created in the current directory and 
its name is derived from the name of the RCS file by removing pathl/ and the suffix ‘,v\ 

3) Only the working file is given. Then the name of the RCS file is derived from the name of 
the working file by removing paths/ and appending the suffix ‘,v’. 

If the RCS file is omitted or specified without a path, then co looks for the RCS file first in 
the directory ./RCS and then in the current directory. 

Revisions of an RCS file may be checked out locked or unlocked. Locking a revision prevents 
overlapping updates. A revision checked out for reading or processing (e.g., compiling) need 
not be locked. A revision checked out for editing and later checkin must normally be locked. 
Locking a revision currently locked by another user fails. (A lock may be broken with the res 
(1) command.) Co with locking requires the caller to be on the access list of the RCS file, 
unless he is the owner of the file or the superuser, or the access list is empty. Co without 
locking is not subject to accesslist restrictions. 

A revision is selected by number, checkin date/time, author, or state. If none of these 
options are specified, the latest revision on the trunk is retrieved. When the options are 
applied in combination, the latest revision that satisfies all of them is retrieved. The options 
for date/time, author, and state retrieve a revision on the selected branch. The selected 
branch is either derived from the revision number (if given), or is the highest branch on the 
trunk. A revision number may be attached to one of the options -1, -p, -q, or -r. 

A co command applied to an RCS file with no revisions creates a zero-length file. Co always 
performs keyword substitution (see below). 

—l[rev] locks the checked out revision for the caller. If omitted, the checked out revi¬ 

sion is not locked. See option -r for handling of the revision number rev. 

—p[rev] prints the retrieved revision on the std. output rather than storing it in the 

working file. This option is useful when co is part of a pipe. 

—q[ret/] quiet mode; diagnostics are not printed. 

—d date retrieves the latest revision on the selected branch whose checkin date/time is 

less than or equal to date. The date and time may be given in free format and 
are converted to local time. Examples of formats for date : 

22-April-1982, 17.S0-CDT, 

2:25 AM, Dec. 29, 1988, 

Tue-PDT, 1981, \pm Jul 21 (free format), 
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Fri, April 16 15:52:25 EST 1982 (output of ctime). V_y 

Most fields in the date and time may be defaulted. Co determines the defaults 
in the order year, month, day, hour, minute, and second (most to least 
significant). At least one of these fields must be provided. For omitted fields that 
are of higher significance than the highest provided field, the current values are 
assumed. For all other omitted fields, the lowest possible values are assumed. 

For example, the date "20, 10:30" defaults to 10:30:00 of the 20th of the current 
month and current year. The date/time must be quoted if it contains spaces. 

—r[rev] retrieves the latest revision whose number is less than or equal to rev. If rev 

indicates a branch rather than a revision, the latest revision on that branch is 
retrieved. Rev is composed of one or more numeric or symbolic fields separated 
by The numeric equivalent of a symbolic field is specified with the -n option 
of the commands ci and res. 

—Bstate retrieves the latest revision on the selected branch whose state is set to state. 

—-wf/opin] retrieves the latest revision on the selected branch which was checked in by the 

user with login name login. If the argument login is omitted, the caller’s login is 
assumed. 

—j joinlist generates a new revision which is the join of the revisions on joinlist. Joinlist is 

a comma-separated list of pairs of the form rev2:rev8, where rev2 and revS are 
(symbolic or numeric) revision numbers. For the initial such pair, revl denotes 
the revision selected by the options -1, ..., -w. For all other pairs, revl denotes 
the revision generated by the previous pair. (Thus, the output of one join 
becomes the input to the next.) 

For each pair, co joins revisions revl and revS with respect to rev2. This means 
that all changes that transform rev2 into revl are applied to a copy of revS. 

This is particularly useful if revl and revS are the ends of two branches that 
have rev2 as a common ancestor. If revl < rev2 < revS on the same branch, 
joining generates a new revision which is like revS, but with all changes that 
lead from revl to rev2 undone. If changes from rev2 to revl overlap with 
changes from rev2 to revS, co prints a warning and includes the overlapping sec¬ 
tions, delimited by the lines <««« revl, == ===== and 

»»»> revS. 

For the initial pair, rev2 may be omitted. The default is the common ancestor. 

If any of the arguments indicate branches, the latest revisions on those branches 
are assumed. If the option -1 is present, the initial revl is locked. 

KEYWORD SUBSTITUTION 

Strings of the form $keyword$ and $keyword:...$ embedded in the text are replaced with 
strings of the form tkeyword: value $, where keyword and value are pairs listed below. Key¬ 
words may be embedded in literal strings or comments to identify a revision. 

Initially, the user enters strings of the form $keyword$. On checkout, co replaces these 
strings with strings of the form tkeyword: value $. If a revision containing strings of the 
latter form is checked back in, the value fields will be replaced during the next checkout. 

Thus, the keyword values are automatically updated on checkout. 
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Keywords and their corresponding values: 


$Author$ The login name of the user who checked in the revision. 300. Class$ 

$Date$ The date and time the revision was checked in. 


$Header$ 

$Locker$ 

$Log$ 


A standard header containing the RCS file name, the revision number, the 
date, the author, and the state. 

The login name of the user who locked the revision (empty if not locked). 

The log message supplied during checkin, preceded by a header containing the 
RCS file name, the revision number, the author, and the date. Existing log 
messages are NOT replaced. Instead, the new log message is inserted after 
%Log:...$. This is useful for accumulating a complete change log in a source 
file. 


$Revision$ The revision number assigned to the revision. 
$Source$ The full pathname of the RCS file. 

$State$ The state assigned to the revision with res -s or ci -s. 


DIAGNOSTICS 

The RCS file name, the working file name, and the revision number retrieved are written to 
the diagnostic output. The exit status always refers to the last file checked out, and is 0 if 
the operation was successful, 1 otherwise. 


EXAMPLES 

Suppose the current directory contains a subdirectory ‘RCS’ with an RCS file ‘io.c,v’. Then 
all of the following commands retrieve the latest revision from ‘RCS/io.c,v’ and store it into 
‘io.c’. 

co io.c; co RCS/io.c,v; co io.c,v; 
co io.c RCS/io.c,v; co io.c io.c,v; 
co RCS/io.c,v io.c; co io.c,v io.c; 

FILE MODES 

The working file inherits the read and execute permissions from the RCS file. In addition, the 
owner write permission is turned on, unless the file is checked out unlocked and locking is set 
to strict (see res (l)). 

If a file with the name of the working file exists already and has write permission, co aborts 
the checkout if -q is given, or asks whether to abort if -q is not given. If the existing working 
file is not writable, it is deleted before the checkout. 


FILES 

The caller of the command must have write permission in the working directory, read per¬ 
mission for the RCS file, and either read permission (for reading) or read/write permission 
(for locking) in the directory which contains the RCS file. 

A number of temporary files are created. A semaphore file is created in the directory of the 
RCS file to prevent simultaneous update. 

IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 3.1 ; Release Date: 83/04/04 . 
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Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

ci (1), ident(l), res (1), resdiff (1), rcsintro (1), resmerge (1), rlog (1), resfile (5), sccstorcs (8). 
Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 

LIMITATIONS 

The option -d gets confused in some circumstances, and accepts no date before 1970. There 
is no way to suppress the expansion of keywords, except by writing them differently. In nroff 
and troff, this is done by embedding the null-character ‘\&’ into the keyword. 

BUGS 

The option -j does not work for files that contain lines with a single V. 
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NAME 

col - filter reverse line feeds 

SYNOPSIS 

col [ —bfx ] 

DESCRIPTION 

Col reads the standard input and writes the standard output. It performs the line overlays 
implied by reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds 
(ESC-9 and ESC-8). Col is particularly useful for filtering multicolumn output made with the 
‘.rt’ command of nroff and output resulting from use of the <6/(1) preprocessor. 

Although col accepts half line motions in its input, it normally does not emit them on output. 
Instead, text that would appear between lines is moved to the next lower full line boundary. 
This treatment can be suppressed by the —f (fine) option; in this case the output from col 
may contain forward half line feeds (ESC-9), but will still never contain either kind of reverse 
line motion. 

If the —b option is given, col assumes that the output device in use is not capable of back¬ 
spacing. In this case, if several characters are to appear in the same place, only the last one 
read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text 
in an alternate character set. The character set (primary or alternate) associated with each 
printing character read is remembered; on output, SO and SI characters are generated where 
necessary to maintain the correct treatment of each character. 

Col normally converts white space to tabs to shorten printing time. If the —x option is given, 
this conversion is suppressed. 

All control characters are removed from the input except space, backspace, tab, return, new- 
line, ESC (033) followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an 
alternate form of full reverse line feed, for compatibility with some other hardware conven¬ 
tions. All other non-printing characters are ignored. 

SEE ALSO 

troff(l), tbl(l) 


BUGS 

Can’t back up more than 128 lines. 

No more than 800 characters, including backspaces, on a line. 
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NAME 

colcrt - filter nroff output for CRT previewing 

SYNOPSIS 

colcrt [ — ] [ —2 ] [ file ... ] 

DESCRIPTION 

Colcrt provides virtual half-line and reverse line feed sequences for terminals without such 
capability, and on which overstriking is destructive. Half-line characters and underlining 
(changed to dashing *-*) are placed on new lines in between the normal output lines. 

The optional — suppresses all underlining. It is especially useful for previewing allboxed tables 
from tbl( l). 

The option —2 causes all half-lines to be printed, effectively double spacing the output. Nor¬ 
mally, a minimal space output format is used which will suppress empty lines. The program 
never suppresses two consecutive empty lines, however. The —2 option is useful for sending 
output to the line printer when the output contains superscripts and subscripts which would 
otherwise be invisible. 

A typical use of colcrt would be 

tbl exum2.n | nroff -ms | colcrt - | more 


SEE ALSO 

nroff/troff(l), col(l), more(l), ul(l) 

AUTHOR 

William' Joy 


BUGS 

Should fold underlines onto blanks even with the option so that a true underline character 
would show; if w r e did this, however, colcrt wouldn’t get rid of cu’d underlining completely. 

Can’t back up more than 102 lines. 

General overstriking is lost; as a special case ‘|’ overstruck with or underline becomes ‘+’. 
Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and subscripts in documents which 
are already double-spaced. 
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NAME 

colrm - remove columns from a file 
SYNOPSIS 

colrm [ started [ endcol ] ] 

DESCRIPTION 

Colrm removes selected columns from a file. Input is taken from standard input. Output is 
sent to standard output. 

If called with one parameter the columns of each line will be removed starting with the 
specified column. If called with two parameters the columns from the first column to the last 
column will be removed. 

Column numbering starts with column 1. 

SEE ALSO 

expand(l) 

AUTHOR 

Jeff Schriebman 
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NAME 

comm - select or reject lines common to two sorted files 

SYNOPSIS 

comm [ - [ 123 ] ] filel file2 
DESCRIPTION 

Comm reads filel and file2, which should be ordered in ASCII collating sequence, and pro¬ 
duces a three column output: lines only in filel; lines only in fileS; and lines in both files. The 
filename means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm —12 prints only 
the lines common to the two files; comm -23 prints only lines in the first file but not in the 
second; comm -123 is a no-op. 

SEE ALSO 

cmp(l), diff(l), uniq(l) 
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NAME 

compact, uncompact, ccat - compress and uncompress files, and cat them 

SYNOPSIS 

compact [ name ... ] 
uncompact [ name ... ] 
ccat [ file ... ] 

DESCRIPTION 

Compact compresses the named files using an adaptive Huffman code. If no file names are 
given, the standard input is compacted to the standard output. Compact operates as an on¬ 
line algorithm. Each time a byte is read, it is encoded immediately according to the current 
prefix code. This code is an optimal Huffman code for the set of frequencies seen so far. It is 
unnecessary to prepend a decoding tree to the compressed file since the encoder and the 
decoder start in the same state and stay synchronized. Furthermore, compact and uncompact 
can operate as filters. In particular, 

... | compact | uncompact | ... 

operates as a (very slow) no-op. 

When an argument file is given, it is compacted and the resulting file is placed in file.C; file is 
unlinked. The first two bytes of the compacted file code the fact that the file is compacted. 
This code is used to prohibit recompaction. 

The amount of compression to be expected depends on the type of file being compressed. 
Typical values of compression are: Text (38%), Pascal Source (43%), C Source (36%) and 
Binary (19%). These values are the percentages of file bytes reduced. 

Uncompact restores the original file from a file compressed by compact. If no file names are 
given, the standard input is uncompacted to the standard output. 

Ccat cats the original file from a file compressed by compact, without uncompressing the file. 

RESTRICTION 

The last segment of the filename must contain fewer than thirteen characters to allow space 
for the appended \C’. 


FILES 

*.C compacted file created by compact, removed by uncompact 

SEE ALSO 

Gallager, Robert G., ‘Variations on a Theme of Huffman’, I.E.E.E. Transactions on Informa¬ 
tion Theory, vol. IT-24, no. 6, November 1978, pp. 668 - 674. 


AUTHOR 

Colin L. Me Master 
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NAME 

compress, uncompress, zcat - compress and expand data 

SYNOPSIS 

compress [ -f ] [ —v ] [ -c ] { -b bits ] [ name ... ] 
uncompress [ -f ] [ -v ] [ — c ] { name ... ] 
zcat [ name ... ] 

DESCRIPTION 

Compress reduces the size of the named files using adaptive Lempel-Ziv coding. Whenever 
possible, each file is replaced by one with the extension .Z, while keeping the same ownership 
modes, access and modification times. If no files are specified, the standard input is 
compressed to the standard output. Compressed files can be restored to their original form 
using uncompress or zcat. 

The —f option will force compression of name, even if it does not actually shrink or the 
corresponding name. Z file already exists. Except when run in the background under /bin/sh, 
if —f is not given the user is prompted as to whether an existing name. Z file should be 
overwritten. 

The —c (“cat”) option makes compress/uncompress write to the standard output; no files are 
changed. The nondestructive behavior of zcat is identical to that of uncompress -c. 

Compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for High Per¬ 
formance Data Compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 (June 1984), pp. 
8-19. Common substrings in the file are first replaced by 9-bit codes 257 and up. When code 
512 is reached, the algorithm switches to 10-bit codes and continues to use more bits until the 
limit specified by the -b flag is reached (default 16). Bits must be between 9 and 16. The 
default can be changed in the source to allow compress to be run on a smaller machine. 

After the bits limit is attained, compress periodically checks the compression ratio. If it is 
increasing, compress continues to use the existing code dictionary. However, if the compres¬ 
sion ratio decreases, compress discards the table of substrings and rebuilds it from scratch. 
This allows the algorithm to adapt to the next "block" of the file. 

Note that the —b flag is omitted for uncompress, since the bits parameter specified during 
compression is encoded within the output, along with a magic number to ensure that neither 
decompression of random data nor recompression of compressed data is attempted. 

The amount of compression obtained depends on the size of the input, the number of bits per 
code, and the distribution of common substrings. Typically, text such as source code or 
English is reduced by 50-60%. Compression is generally much better than that achieved by 
Huffman coding (as used in pack), or adaptive Huffman coding (compact), and takes less time 
to compute. 

The -v option causes the printing of the percentage reduction of each file. 

If an error occurs, exit status is 1, else if the last file was not compressed because it became 
larger, the status is 2; else the status is 0. 

DIAGNOSTICS 

Usage: compress [-fvc] [-b maxbits] [file ...] 

Invalid options were specified on the command line. 

Missing maxbits 

Maxbits must follow -b. 
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file: not in compressed format 

The file specified to uncompress has not been compressed. 
file: compressed with xx bits, can only handle yy bits 

File was compressed by a program that could deal with more bits than the 
compress code on this machine. Recompress the file with smaller bits, 
file: already has .Z suffix -- no change 

The file is assumed to be already compressed. Rename the file and try 
again. 

file: filename too long to tack on .Z 

The file cannot be compressed because its name is longer than 12 charac¬ 
ters. Rename and try again. This message does not occur on BSD systems. 
file already exists; do you wish to overwrite (y or n)? 

Respond ”y" if you want the output file to be replaced; "n" if not. 
uncompress: corrupt input 

A SIGSEGV violation was detected which usually means that the input file 
is corrupted. 

Compression: xx.xx% 

Percentage of the input saved by compression. (Relevant only for —v.) 

-- not a regular file: unchanged 

When the input file is not a regular file, (e.g. a directory), it is left unal¬ 
tered. 

-- has xx other links: unchanged 

The input file has links: it is left unchanged. See /n(l) for more informa¬ 
tion. 

-- file unchanged 

No savings is achieved by compression. The input remains virgin. 


BUGS 

Although compressed files are compatible between machines with large memory, —bl2 should 
be used for file transfer to architectures with a small process data space (64KB or less, as exhi¬ 
bited by the DEC PDP series, the Intel 80286, etc.) 

compress should be more flexible about the existence of the ‘.Z’ suffix. 
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NAME 

cp - copy 

SYNOPSIS 

cp [ -i ] [ — r ] [ —t ] filel file2 
cp [ -i ] [ —r ] [ —t ] file ... directory 



DESCRIPTION 

Filel is copied onto fileS. The mode and owner of file2 are preserved if it already existed; the 
mode of the source file is used otherwise. 

In the second form, one or more files are copied into the directory with their original file¬ 
names. 

Cp refuses to copy a file onto itself. 

If the -i option is specified, cp will prompt the user with the name of the file whenever the 
copy will cause an old file to be overwritten. An answer of ’y’ will cause cp to continue. Any 
other answer will prevent it from overwriting the file. 

If the -r option is specified and any of the source files are directories, cp copies each subtree 
rooted at that name; in this case the destination must be a directory. Otherwise, if the -r 
flag is not specified, directories will not be copied. 

If the -t option is specified, the time stamp on the destination file will be set to the time 
stamp of the source file. 

SEE ALSO 

cat(l), pr(l), mv(l) 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cpio —o [ acBv ] 

cpio -i [ BcdmrtuvfsSbB ] [ patterns ] 
cpio —p [ adlmruv ] directory 

DESCRIPTION 

Cpio -o (copy out) reads the standard input to get a list of path names and copies those files 
onto the standard output together with path name and status information. 

Cpio — i (copy in) reads the standard input (which is assumed to be the product of a previous 
Cpio — o command), to get a list of files selected by zero or more patterns as defined in the 
name-generating notation of sh{ 1) or csh( 1). In patterns , the meta-characters ?, *, and [... ] 
match the slash (/) character. The default for patterns is * (select all files). 

Cpio -p (pass) copies out and in in a single operation. Destination pathnames are inter¬ 
preted relative to the named directory . 

OPTIONS 

a Reset the access times of input files after they have been copied. 

B Input/output is to be blocked at 5120 bytes to the record. This does not apply to the 

pass option. This option is only meaningful with data directed to or from /dev/rmt? 

d Directories should be created as needed. 

c Write header information in ASCII character form for portability, 
r Interactively rename files. If the user types a null line, the file is skipped, 
t Print a Table of contents of the input. No files are created. 

u Copy unconditionally. Normally, an older file will not replace a newer file with the 

same name. 

v Verbose option. A list of filenames is displayed. When used with the t option, the 

table of contents looks like the output of an Is -1 command (see ls( 1)). 

1 Whenever possible, link files rather than copying them. Usable only with the -p 

option. 

m Retain previous file modification time. This option is ineffective on directories that are 
being copied. 

f Copy in all files execpt those in patterns . 

s Swap bytes. User only with the — i option. 

5 Swap halfwords. Use only with the -i option. 

b Swap both bytes and halfwords. Use only with the -i option. 

6 Process an old (version 6 UNIX system) file. This is only useful with —i (copy in). 

EXAMPLES 

To copy the contents of a directory into an archive: 

% Is | cpio -o > /dev/mtO 
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To duplicate the olddir directory hierarchy in the newdir directory: 

% cd olddir 

% find . —print | cpio —pdl newdir 

Some forms of cpio tapes from other sites have the bytes swapped in the file. The s option 
doesn’t help since it only swaps the data bytes and not the header. To overcome this prob¬ 
lem, use dd with the conv=swab option to swap all pairs of bytes (including the header), 
then pipe the output of dd through cpio with the s option to swap the data bytes back again: 

% dd if= whatever the file is conv=swab | cpio -is 

SEE ALSO 

ar(l), find(l), cpio(5) 


BUGS 

Pathnames are restricted to 128 characters. If there are too many unique linked files, cpio 
runs out of memory to keep track of them and linking information is lost thereafter. Only 
the super-user can copy special files. 
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NAME 

crypt - encode/decode 

SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. The password is a 
key that selects a particular transformation. If no password is given, crypt demands a key 
from the terminal and turns off printing while the key is being typed in. Crypt encrypts and 
decrypts with the same key: 

crypt key <clear >cypher 
crypt key Ccypher | pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor ed in encryption 
mode. 

The security of encrypted files depends on three factors: the fundamental method must be 
hard to solve; direct search of the key space must be infeasible; ‘sneak paths’ by which keys or 
cleartext can become visible must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the German Enigma, but 
with a 256-element rotor. Methods of attack on such machines are known, but not widely; 
moreover the amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed 
to be expensive, i.e. to take a substantial fraction of a second to compute. However, if keys 
are restricted to (say) three lower-case letters, then encrypted files can be read by expending 
only a substantial fraction of five minutes of machine time. 

Since the key is an argument to the crypt command, it is potentially visible to users executing 
ps(l) or a derivative. To minimize this possibility, crypt takes care to destroy any record of 
the key immediately upon entry. No doubt the choice of keys and key security are the most 
vulnerable aspect of crypt. 


FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(8) 


BUGS 

There is no warranty of merchantability nor any warranty of fitness for a particular purpose 
nor any other warranty, either express or implied, as to the accuracy of the enclosed materials 
or as to their suitability for any particular purpose. Accordingly, Bell Telephone Laboratories 
assumes no responsibility for their use by the recipient. Further, Bell Laboratories assumes 
no obligation to furnish any assistance of any kind whatsoever, or to furnish any additional 
information or documentation. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 
SYNOPSIS 

csh [ —cefinstvVxX ] [ arg ... ] 

DESCRIPTION 

Csh is a first implementation of a command language interpreter incorporating a history 
mechanism (see History Substitutions) job control facilities (see Jobs) and a C-like syntax. 
So as to be able to use its job control facilities, users of csh must (and automatically) use the 
new tty driver fully described in tty{ 4). This new tty driver allows generation of interrupt 
characters from the keyboard to tell jobs to stop. See stty{ 1) for details on setting options in 
the new tty driver. 

An instance of csh begins by executing commands from the file ‘.cshrc’ in the home directory 
of the invoker. If this is a login shell then it also executes commands from the file ‘.login' 
there. It is typical for users on crt’s to put the command “stty crt” in their .login file, and to 
also invoke teet(l) there. 

In the normal case, the shell will then begin reading commands from the terminal, prompting 
with ‘% ’. Processing of arguments and the use of the shell to process files containing com¬ 
mand scripts will be described later. 

The shell then repeatedly performs the following actions: a line of command input is read and 
broken into words. This sequence of words is placed on the command history list and then 
parsed. Finally each command in the current line is executed. 

When a login shell terminates it executes commands from the file ‘.logout’ in the users home 
directory. 

Lexical Structure 

The shell splits input lines into words at blanks and tabs with the following exceptions. The 
characters *&’ ‘|’ ‘<’ ‘>’ ‘(’ ')’ form separate words. If doubled in ‘| |’, ‘<< : or 

‘>>’ these pairs form single words. These parser metacharacters may be made part of other 
words, or prevented their special meaning, by preceding them with ‘\\ A newline preceded by 
a ‘\’ is equivalent to a blank. 

In addition strings enclosed in matched pairs of quotations, ‘°, ‘ v ’ or form parts of a word; 
metacharacters in these strings, including blanks and tabs, do not form separate words. 
These quotations have semantics to be described subsequently. Within pairs of ‘° or char¬ 
acters a newline preceded by a gives a true newline character. 

When the shell’s input is not a terminal, the character *#’ introduces a comment which con¬ 
tinues to the end of the input line. It is prevented this special meaning when preceded by ‘Y 
and in quotations using *'*, and 

Commands 

A simple command is a sequence of words, the first of which specifies the command to be exe¬ 
cuted. A simple command or a sequence of simple commands separated by ‘|’ characters 
forms a pipeline. The output of each command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by and are then executed sequentially. A 
sequence of pipelines may be executed without immediately waiting for it to terminate by fol¬ 
lowing it with an *&’. 

Any of the above may be placed in ‘(’ *)’ to form a simple command (which may be a com¬ 
ponent of a pipeline, etc.) It is also possible to separate pipelines with ‘| |’ or ‘&&’ indicating. 
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as in the C language, that the second is to be executed only if the first fails or succeeds respec¬ 
tively. (See Expressions.) 

Jobs 

The shell associates a job with each pipeline. It keeps a table of current jobs, printed by the 
jobs command, and assigns them small integer numbers. When a job is started asynchro¬ 
nously with the shell prints a line which looks like: 

(1] 1234 

indicating that the jobs which was started asynchronously was job number 1 and had one 
(top-level) process, whose process id was 1234. 

If you are running a job and wish to do something else you may hit the key A Z (control-Z) 
which sends a STOP signal to the current job. The shell will then normally indicate that the 
job has been ‘Stopped’, and print another prompt. You can then manipulate the state of this 
job, putting it in the background with the bg command, or run some other commands and 
then eventually bring the job back into the foreground with the foreground command fg. A 
A Z takes effect immediately and is like an interrupt in that pending output and unread input 
are discarded when it is typed. There is another special key A Y which does not generate a 
STOP signal until a program attempts to read(2) it. This can usefully be typed ahead when 
you have prepared some commands for a job which you wish to stop after it has read them. 

A job being run in the background will stop if it tries to read from the terminal. Background 
jobs are normally allowed to produce output, but this can be disabled by giving the command 
“stty tostop”. If you set this tty option, then background jobs will stop when they try to 
produce output like they do when they try to read input. 

There are several ways to refer to jobs in the shell. The character ‘% > introduces a job name. 
If you wish to refer to job number 1, you can name it as ‘%1\ Just naming a job brings it to 
the foreground; thus ‘%1’ is a synonym for ‘fg %V, bringing job 1 back into the foreground. 
Similarly saying ‘%1 &’ resumes job 1 in the background. Jobs can also be named by prefixes 
of the string typed in to start them, if these prefixes are unambiguous, thus ‘%ex’ would nor¬ 
mally restart a suspended ex(l) job, if there were only one suspended job whose name began 
with the string ‘ex’. It is also possible to say ‘%?string’ which specifies a job whose text con¬ 
tains string, if there is only one such job. 

The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, 
the current job is marked with a *+’ and the previous job with a The abbreviation l %~ 
refers to the current job and *%-’ refers to the previous job. For close analogy with the syn¬ 
tax of the history mechanism (described below), *%%’ is also a synonym for the current job. 

Status Reporting 

This shell learns immediately whenever a process changes state. It normally informs you 
whenever a job becomes blocked so that no further progress is possible, but only just before it 
prints a prompt. This is done so that it does not otherwise disturb your work. If, however, 
you set the shell variable notify, the shell will notify you immediately of changes of status in 
background jobs. There is also a shell command notify which marks a single process so that 
its status changes will be immediately reported. By default notify marks the current process: 
simply say ‘notify’ after starting a background job to mark it. 

When you try to leave the shell while jobs are stopped, you will be warned that ‘You have 
stopped jobs.’ You may use the jobs command to see what they are. If you do this or 
immediately try to exit again, the shell will not warn you a second time, and the suspended 
jobs will be terminated. 
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Substitutions 

We now describe the various transformations, the shell performs on the input in the order in 
which they occur. 

History Substitutions 

History substitutions place words from previous command input as portions of new com¬ 
mands, making it easy to repeat commands, repeat arguments of a previous command in the 
current command, or fix spelling mistakes in the previous command with little typing and a 
high degree of confidence. History substitutions begin with the character *!’ and may begin 
anywhere in the input stream (with the proviso that they do not nest.) This ‘!’ may be pre¬ 
ceded by an *\* to prevent its special meaning; for convenience, a T is passed unchanged when 
it is followed by a blank, tab, newline, '=’ or ‘(’. (History substitutions also occur when an 
input line begins with ‘f\ This special abbreviation will be described later.) Any input line 
which contains history substitution is echoed on the terminal before it is executed as it could 
have been typed without history substitution. 

Commands input from the terminal which consist of one or more words are saved on the his¬ 
tory list. The history substitutions reintroduce sequences of words from these saved com¬ 
mands into the input stream. The size of which is controlled by the history variable; the pre¬ 
vious command is always retained, regardless of its value. Commands are numbered sequen¬ 
tially from 1. 

For definiteness, consider the following output from the history command: 

9 write michael 

10 ex write.c 

11 cat old write.c 

12 diff ♦write.c 

The commands are shown with their event numbers. It is not usually necessary to use event 
numbers, but the current event number can be made part of the prompt by placing an T in 
the prompt string. 

With the current event 13 we can refer to previous events by event number ‘111’, relatively as 
in ‘1-2’ (referring to the same event), by a prefix of a command word as in ‘Id’ for event 12 or 
Mwri’ for event 9, or by a string contained in a word in the command as in ‘!?mic?’ also refer¬ 
ring to event 9. These forms, without further modification, simply reintroduce the words of 
the specified events, each separated by a single blank. As a special case ‘IP refers to the previ¬ 
ous command; thus ‘IP alone is essentially a redo. 

To select words from an event we can follow the event specification by a and a designator 
for the desired words. The words of a input line are numbered from 0, the first (usually com¬ 
mand) word being 0, the second word (first argument) being 1, etc. The basic word designa¬ 
tors are: 

0 first (command) word 

n n’th argument 

t first argument, i.e. ‘1’ 

$ last argument 

% word matched by (immediately preceding) 

?s? search 

x-y range of words 

-y abbreviates ‘0-y ’ 

* abbreviates or nothing if only 1 word 
in event 

x* abbreviates ‘;r-$’ 

x- like ‘x *’ but omitting word ‘$’ 
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The V separating the event specification from the word designator can be omitted if the argu¬ 
ment selector begins with a ‘f, ‘$\ or *%’. After the optional word designator can be 

placed a sequence of modifiers, each preceded by a The following modifiers are defined: 


h 

r 

l/l/r/ 

t 

& 

g 

P 

q 

X 


Remove a trailing pathname component, 
leaving the head. 

Remove a trailing ‘.xxx’ component, 
leaving the root name. 

Remove all but the extension ‘.xxx’ part. 
Substitute / for r 

Remove all leading pathname components, 
leaving the tail. 

Repeat the previous substitution. 

Apply the change globally, prefixing the 
above, e.g. ‘g&’. 

Print the new command but do not 
execute it. 

Quote the substituted words, preventing 
further substitutions. 

Like q, but break into words at blanks, 
tabs and newlines. 


Unless preceded by a ‘g’ the modification is applied only to the first modifiable word. With 
substitutions, it is an error for no word to be applicable. 

The left hand side of substitutions are not regular expressions in the sense of the editors, but 
rather strings. Any character may be used as the delimiter in place of ‘/’; a ‘\’ quotes the del¬ 
imiter into the l and r strings. The character *&’ in the right hand side is replaced by the text 
from the left. A ‘\’ quotes also. A null / uses the previous string either from a / or from a 
contextual scan string s in '!?$?’. The trailing delimiter in the substitution may be omitted if 
a newline follows immediately as may the trailing '?’ in a contextual scan. 

A history reference may be given without an event specification, e.g. *!$’. In this case the 
reference is to the previous command unless a previous history reference occurred on the same 
line in which case this form repeats the previous reference. Thus ‘!?foo?f !$’ gives the first and 
last arguments from the command matching ‘?foo?’. 

A special abbreviation of a history reference occurs when the first non-blank character of an 
input line is a ‘f- This is equivalent to ‘!:sT’ providing a convenient shorthand for substitu¬ 
tions on the text of the previous line. Thus ‘tlbtlib’ fixes the spelling of ‘lib’ in the previous 
command. Finally, a history substitution may be surrounded with ‘{’ and ‘}’ if necessary to 
insulate it from the characters which follow'. Thus, after ‘Is -Id ‘paul’ we might do ‘!{l}a’ to 
do ‘Is -Id ~paula’, while ‘!la’ w'ould look for a command starting ‘la’. 

Quotations with ' and " 

The quotation of strings by ‘° and can be used to prevent all or some of the remaining 
substitutions. Strings enclosed in ‘ ° are prevented any further interpretation. Strings 
enclosed in may be expanded as described below'. 


In both cases the resulting text becomes (all or part of) a single word; only in one special case 
(see Command Substitition below) does a quoted string yield parts of more than one word; 
‘ ° quoted strings never do. 
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Alias Substitution 

The shell maintains a list of aliases which can be established, displayed and modified by the 
alias and unalias commands. After a command line is scanned, it is parsed into distinct com¬ 
mands and the first word of each command, left-to-right, is checked to see if it has an alias. 
If it does, then the text which is the alias for that command is reread with the history 
mechanism available as though that command were the previous input line. The resulting 
words replace the command and argument list. If no reference is made to the history list, 
then the argument list is left unchanged. 

Thus if the alias for ‘Is’ is ‘Is -1’ the command ‘Is /usr’ would map to ‘Is -1 /usr’, the argu¬ 
ment list here being undisturbed. Similarly if the alias for ‘lookup’ was ‘grep !| /etc/passwd’ 
then ‘lookup bill’ would map to ‘grep bill /etc/passwd’. 

If an alias is found, the word transformation of the input text is performed and the aliasing 
process begins again on the reformed input line. Looping is prevented if the first word of the 
new text is the same as the old by flagging it to prevent further aliasing. Other loops are 
detected and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can ‘alias 
print 'pr \!* | lpr° to make a command which pr’s its arguments to the line printer. 

Variable Substitution 

The shell maintains a set of variables, each of which has as value a list of zero or more words. 
Some of these variables are set by the shell or referred to by it. For instance, the argv vari¬ 
able is an image of the shell’s argument list, and words of this variable’s value are referred to 
in special ways. 

The values of variables may be displayed and changed by using the set and unset commands. 
Of the variables referred to by the shell a number are toggles; the shell does not care what 
their value is, only whether they are set or not. For instance, the verbose variable is a toggle 
which causes command input to be echoed. The setting of this variable results from the -v 
command line option. 

Other operations treat variables numerically. The command permits numeric calculations 
to be performed and the result assigned to a variable. Variable values are, however, always 
represented as (zero or more) strings. For the purposes of numeric operations, the null string 
is considered to be zero, and the second and subsequent words of multiword values are 
ignored. 

After the input line is aliased and parsed, and before each command is executed, variable sub¬ 
stitution is performed keyed by '$’ characters. This expansion can be prevented by preceding 
the *$’ with a ‘\’ except within ‘"’s where it always occurs, and within "’s where it never 
occurs. Strings quoted by are interpreted later (see Command substitution below) so *$’ 
substitution does not occur there until later, if at all. A ‘$’ is passed unchanged if followed by 
a blank, tab, or end-of-line. 

Input/output redirections are recognized before variable expansion, and are variable expanded 
separately. Otherwise, the command name and entire argument list are expanded together. It 
is thus possible for the first (command) word to this point to generate more than one word, 
the first of which becomes the command name, and the rest of which become arguments. 

Unless enclosed in ‘"’ or given the ‘:q’ modifier the results of variable substitution may eventu¬ 
ally be command and filename substituted. Within ‘"’ a variable whose value consists of mul¬ 
tiple words expands to a (portion of) a single word, with the words of the variables value 
separated by blanks. When the ‘:q’ modifier is applied to a substitution the variable will 
expand to multiple words with each word separated by a blank and quoted to prevent later 
command or filename substitution. 
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The following metasequences are provided for introducing variable values into the shell input. 
Except as noted, it is an error to reference a variable which is not set. 

$name 

${name} 

Are replaced by the words of the value of variable name, each separated by a blank. 
Braces insulate name from following characters which would otherwise be part of it. 
Shell variables have names consisting of up to 20 letters and digits starting w'ith a letter. 
The underscore character is considered a letter. 

If name is not a shell variable, but is set in the environment, then that value is returned 
(but : modifiers and the other forms given below are not available in this case). 

$name[selector] 

${n ame [selector]} 

May be used to select only some of the words from the value of name. The selector is 
subjected to substitution and may consist of a single number or two numbers 
separated by a ‘-\ The first word of a variables value is numbered *1’. If the first 
number of a range is omitted it defaults to T’. If the last member of a range is omitted 
it defaults to ‘$#name\ The selector V selects all words. It is not an error for a range 
to be empty if the second argument is omitted or in range. 

$#name 

${#name} 

Gives the number of words in the variable. This is useful for later use in a ‘[selector]’. 

$0 

Substitutes the name of the file from which command input is being read. An error 
occurs if the name is not known. 

Snumber 

${number} 

Equivalent to ‘$argv[number]\ 

$* 

Equivalent to l $argv[*]’. 

The modifiers ‘:h’, ‘:t’, ‘:r’, ‘:q’ and ‘:x’ may be applied to the substitutions above as may 
‘:gh’, ‘:gt’ and ‘:gr’. If braces *{’ ’}’ appear in the command form then the modifiers must 
appear within the braces. The current implementation allows only one modifier on 
each *$’ expansion. 

The following substitutions may not be modified with modifiers. 

$?name 

${?name} 

Substitutes the string T’ if name is set, ‘0’ if it is not. 

$?0 

Substitutes ‘T if the current input filename is known, ‘O’ if it is not. 

$$ 

Substitute the (decimal) process number of the (parent) shell. 

$< 

Substitutes a line from the standard input, with no further interpretation thereafter. It 
can be used to read from the keyboard in a shell script. 
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Command and Filename Substitution 

The remaining substitutions, command and filename substitution, are applied selectively to 
the arguments of builtin commands. This means that portions of expressions which are not 
evaluated are not subjected to these expansions. For commands which are not internal to the 
shell, the command name is substituted separately from the argument list. This occurs very 
late, after input-output redirection is performed, and in a child of the main shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in The output from such a 
command is normally broken into separate words at blanks, tabs and newlines, with null 
words being discarded, this text then replacing the original string. Within ‘"’s, only newlines 
force new words; blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that it is thus possible 
for a command substitution to yield only part of a word, even if the command outputs a com¬ 
plete line. 

Filename Substitution 

If a w'ord contains any of the characters V, '?’, *{’ or ‘{’ or begins with the character then 
that word is a candidate for filename substitution, also known as ‘globbing’. This word is 
then regarded as a pattern, and replaced with an alphabetically sorted list of file names which 
match the pattern. In a list of words specifying filename substitution it is an error for no pat¬ 
tern to match an existing file name, but it is not required for each pattern to match. Only 
the metacharacters V, '?’ and ‘[’ imply pattern matching, the characters and *{’ being 
more akin to abbreviations. 

In matching filenames, the character ‘.’ at the beginning of a filename or immediately follow¬ 
ing a as well as the character ‘/’ must be matched explicitly. The character matches 
any string of characters, including the null string. The character *?’ matches any single char¬ 
acter. The sequence '[...]’ matches any one of the characters enclosed. Within a pair °f 

characters separated by *-’ matches any character lexically between the two. 

The character at the beginning of a filename is used to refer to home directories. Standing 
alone, i.e. it expands to the invokers home directory as reflected in the value of the vari¬ 
able home. When followed by a name consisting of letters, digits and ‘-’ characters the shell 
searches for a user with that name and substitutes their home directory; thus ‘~ken’ might 
expand to ‘/usr/ken’ and ‘~ken/chmach’ to ‘/usr/ken/chmach’. If the character ‘"’ is fol¬ 
lowed by a character other than a letter or ‘/’ or appears not at the beginning of a word, it is 
left undisturbed. 

The metanotation ‘a{b,c,d}e’ is a shorthand for ‘abe ace ade’. Left to right order is preserved, 
with results of matches being sorted separately at a low level to preserve this order. This con¬ 
struct may be nested. Thus ‘~source/sl/{oldls,ls}.c’ expands to Yusr/source/sl/oldls.c 
/usr/source/sl/ls.c’ whether or not these files exist without any chance of error if the home 
directory for ‘source’ is ‘/usr/source’. Similarly ‘../{memo,*box}’ might expand to ‘../memo 
../box ../mbox’. (Note that ‘memo’ was not sorted with the results of matching ‘*box’.) As a 
special case '{’, *}’ and '{}’ are passed undisturbed. 


Input/Output 

The standard input and standard output of a command may be redirected with the following 
syntax: 

< name 

Open file name (vrhich is first variable, command and filename expanded) as the stan¬ 
dard input. 
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<< word 

Read the shell input up to a line which is identical to word. Word is not subjected to 
variable, filename or command substitution, and each input line is compared to word 
before any substitutions are done on this input line. Unless a quoting ‘\’, or <M 

appears in word variable and command substitution is performed on the intervening 
lines, allowing ‘\’ to quote ‘\’ and Commands which are substituted have all 
blanks, tabs, and newlines preserved, except for the final newline which is dropped. The 
resultant text is placed in an anonymous temporary file which is given to the command 
as standard input. 

> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not exist then it is created; if 
the file exists, its is truncated, its previous contents being lost. 

If the variable noclobber is set, then the file must not exist or be a character special file 
(e.g. a terminal or ‘/dev/nulP) or an error results. This helps prevent accidental des¬ 
truction of files. In this case the T forms can be used and suppress this check. 

The forms involving route the diagnostic output into the specified file as well as the 
standard output. Name is expanded in the same way as *<’ input filenames are. 

>> name 

> >&. name 
>>! name 
>>&! name 

Uses file name as standard output like ‘> ! but places output at the end of the file. If 
the variable noclobber is set, then it is an error for the file not to exist unless one of the 
‘P forms is given. Otherwise similar to “>’. 

A command receives the environment in which the shell was invoked as modified by the 
input-output parameters and the presence of the command in a pipeline. Thus, unlike some 
previous shells, commands run from a file of shell commands have no access to the text of the 
commands by default; rather they receive the original standard input of the shell. The ‘<<’ 
mechanism should be used to present inline data. This permits shell command scripts to 
function as components of pipelines and allows the shell to block read its input. Note that 
the default standard input for a command run detached is not modified to be the empty file 
‘/dev/null’; rather the standard input remains as the original standard input of the shell. If 
this is a terminal and if the process attempts to read from the terminal, then the process will 
block and the user will be notified (see Jobs above.) 

Diagnostic output may be directed through a pipe with the standard output. Simply use the 
form ‘|&’ rather than just ‘|\ 

Expressions 

A number of the builtin commands (to be described subsequently) take expressions, in which 
the operators are similar to those of C, with the same precedence. These expressions appear 
in the exit, if, and while commands. The following operators are available: 

| | && | T & === != =‘ !~ <= >= < > << >>+-*/ % \ ~ 

( ) 

Here the precedence increases to the right, ‘==’ ‘!=’ *="’ and ‘I'’, ’ *>=’ *<’ and 

*>*, l <<’ and ‘>>’, *+’ and V ‘/’ and being, in groups, at the same level. The 
‘==’ ‘!=’ ‘=~’ and *!"’ operators compare their arguments as strings; all others operate on 
numbers. The operators *=”’ and are like “!=’ and *—=’ except that the right hand side 
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is a pattern (containing, e.g. ‘*’s, ‘?’s and instances of ‘against which the left hand 
operand is matched. This reduces the need for use of the switch statement in shell scripts 
when all that is really needed is pattern matching. 

Strings which begin with ‘O’ are considered octal numbers. Null or missing arguments are 
considered ‘O’. The result of all expressions are strings, which represent decimal numbers. It 
is important to note that no two components of an expression can appear in the same word; 
except when adjacent to components of expressions which are syntactically significant to the 
parser (‘&’ ‘|’ *<’ *>’ *(’ ')’) they should be surrounded by spaces. 

Also available in expressions as primitive operands are command executions enclosed in ‘{’ and 
‘}’ and file enquiries of the form ‘-/ name’ where / is one of: 

r read access 

w write access 

x execute access 

e existence 

o ownership 

z zero size 

f plain file 

d directory 

The specified name is command and filename expanded and then tested to see if it. has the 
specified relationship to the real user. If the file does not exist or is inaccessible then all 
enquiries return false, i.e. ‘O’. Command executions succeed, returning true, i.e. ‘1’, if the 
command exits with status 0, otherwise they fail, returning false, i.e. ‘O’. If more detailed 
status information is required then the command should be executed outside of an expression 
and the variable status examined. 

Control Flow 

The shell contains a number of commands which can be used to regulate the flow' of control in 
command files (shell scripts) and (in limited but useful ways) from terminal input. These 
commands all operate by forcing the shell to reread or skip in its input and, due to the imple¬ 
mentation, restrict the placement of some of the commands. 

The foreach, switch, and while statements, as well as the if-then-else form of the if statement 
require that the major keywords appear in a single simple command on an input line as 
shown below. 

If the shell’s input is not seekable, the shell buffers up input whenever a loop is being read 
and performs seeks in this internal buffer to accomplish the rereading implied by the loop. 
(To the extent that this allows, backward goto’s will succeed on non-seekable inputs.) 

Built-In Commands 

Builtin commands are executed within the shell. If a builtin command occurs as any com¬ 
ponent of a pipeline except the last then it is executed in a subshell. 

alias 

alias name 
alias name wordlist 

The first form prints all aliases. The second form prints the alias for name. The final 
form assigns the specified wordlist as the alias of name; wordlist is command and 
filename substituted. Name is not allowed to be alias or unalias. 

alloc 

Shows the amount of dynamic core in use, broken down into used and free core, and 
address of the last location in the heap. With an argument shows each used and free 
block on the internal dynamic memory chain indicating its address, size, and whether it 
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is used or free. This is a debugging command and may not work in production versions 
of the shell; it requires a modified version of the system memory allocator. 

bg 

bg %job ... 

Puts the current or specified jobs into the background, continuing them if they were 
stopped. 

break 

Causes execution to resume after the end of the nearest enclosing foreach or while. The 
remaining commands on the current line are executed. Multi-level breaks are thus possi¬ 
ble by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 

cd 

cd name 

chdir 

chdir name 

Change the shells working directory to directory name. If no argument is given then 
change to the home directory of the user. 

If name is not found as a subdirectory of the current directory (and does not begin with 
*./’ or then each component of the variable cdpatli is checked to see if it has a 

subdirectory name. Finally, if all else fails but name is a shell variable whose value 
begins with ‘/\ then this is tried to see if it is a directory. 

continue 

Continue execution of the nearest enclosing while or foreach. The rest of the commands 
on the current line are executed. 

default: 

Labels the default case in a switch statement. The default should come after all case 
labels. 

dirs 

Prints the directory stack; the top of the stack is at the left, the first directory in the 
stack being the current directory. 

echo wordlist 
echo -n wordlist 

The specified words are written to the shells standard output, separated by spaces, and 
terminated with a newline unless the -n option is specified. 

ebe 

end 

endif 

endsw 

See the description of the foreach, if switch, and while statements below, 
eval arg ... 

(As in sh(l).) The arguments are read as input to the shell and the resulting 
command(s) executed in the context of the current shell. This is usually used to execute 
commands generated as the result of command or variable substitution, since parsing 
occurs before these substitutions. See <se<(l) for an example of using eval. 
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exec command 

The specified command is executed in place of the current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status variable (first form) or with the value 
of the specified expr (second form). 

fg 

fg %job ... 

Brings the current or specified jobs into the foreground, continuing them if they were 
stopped. 

foreach name (wordlist) 
end 

The variable name is successively set to each member of wordlist and the sequence of 
commands between this command and the matching end are executed. (Both foreach 
and end must appear alone on separate lines.) 

The builtin command continue may be used to continue the loop prematurely and the 
built-in command break to terminate it prematurely. When this command is read from 
the terminal, the loop is read up once prompting with ‘?* before any statements in the 
loop are executed. If you make a mistake typing in a loop at the terminal you can rub 
it out. 

glob wordlist 

Like echo but no ‘\’ escapes are recognized and words are delimited by null characters in 
the output. Useful for programs which wish to use the shell to filename expand a list of 
words. 

goto word 

The specified word is filename and command expanded to yield a string of the form 
‘label’. The shell rewinds its input as much as possible and searches for a line of the 
form ‘label:’ possibly preceded by blanks or tabs. Execution continues after the specified 
line. 

hashstat 

Print a statistics line indicating how effective the internal hash table has been at locat¬ 
ing commands (and avoiding ejec’s). An exec is attempted for each component of the 
path where the hash function indicates a possible hit, and in each component which does 
not begin with a ‘/’. 

history 
history n 
history —r n 
history — h n 

Displays the history event list; if n is given only the n most recent events are printed. 
The —r option reverses the order of printout to be most recent first, rather than oldest 
first. The -h option causes the history list to be printed without leading numbers. 
This is used to produce files suitable for sourceing using the -h option to source. 
if (expr) command 

If the specified expression evaluates true, then the single command with arguments is 
executed. Variable substitution on command happens early, at the same time it does for 
the rest of the if command. Command must be a simple command, not a pipeline, a 
command list, or a parenthesized command list. Input/output redirection occurs even if 
expr is false, when command is not executed (this is a bug). 
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if (expr) then 
else if (expr2) then 
else 
endif 

If the specified expr is true then the commands to the first else are executed; else if expr2 
is true then the commands to the second else are executed, etc. Any number of else-if 
pairs are possible; only one endif is needed. The else part is likewise optional. (The 
words else and endif must appear at the beginning of input lines; the if must appear 
alone on its input line or after an else.) 

jobs 
jobs -1 

Lists the active jobs; given the —1 options lists process id’s in addition to the normal 
information. 

kill %job 
kill -sig %job ... 
kill pid 

kill -sig pid ... 

kill -1 

Sends either the TERM (terminate) signal or the specified signal to the specified jobs or 
processes. Signals are either given by number or by names (as given in 
/ usr/include/signal.h, stripped of the prefix “SIG”). The signal names are listed by “kill 
-1”. There is no default, saying just ‘kill’ does not send a signal to the current job. If 
the signal being sent is TERM (terminate) or HUP (hangup), then the job or process will 
be sent a CONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum-use 

Limits the consumption by the current process and each process it creates to not indivi¬ 
dually exceed maximum-use on the specified resource. If no maximum-use is given, then 
the current limit is printed; if no resource is given, then all limitations are given. 

Resources controllable currently include cputime (the maximum number of cpu-seconds 
to be used by each process), filesize (the largest single file which can be created), datasize 
(the maximum growth of the data+stack region via sbrk( 2) beyond the end of the pro¬ 
gram text), stacksize (the maximum size of the automatically-extended stack region), and 
coredumpsize (the size of the largest core dump that will be created). 

The maximum-use may be given as a (floating point or integer) number followed by a 
scale factor. For all limits other than cputime the default scale is ‘k’ or ‘kilobytes’ (1024 
bytes); a scale factor of ‘m’ or ‘megabytes’ may also be used. For cputime the default 
scaling is ‘seconds’, while ‘m’ for minutes or ‘h’ for hours, or a time of the form ‘mm:ss’ 
giving minutes and seconds may be used. 

For both resource names and scale factors, unambiguous prefixes of the names suffice. 

login 

Terminate a login shell, replacing it with an instance of /bin/login. This is one way to 
log off, included for compatibility with sA(l). 

logout 

Terminate a login shell. Especially useful if ignoreeof is set. 
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nice 

nice -fn umber 
nice command 
nice -fnumber command 

The first form sets the nice for this shell to 4. The second form sets the nice to the 
given number. The final two forms run command at priority 4 and number respectively. 
The super-user may specify negative niceness by using ‘nice -number ...’. Command is 
always executed in a sub-shell, and the restrictions place on commands in simple if 
statements apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be ignored for the 
remainder of the script. The second form causes the specified command to be run with 
hangups ignored. All processes detached with ‘&’ are effectively nohup’ed. 

notify 

notify %job ... 

Causes the shell to notify the user asynchronously when the status of the current or 
specified jobs changes; normally notification is presented before a prompt. This is 
automatic if the shell variable notify is set. 

onintr 
onintr - 
onintr label 

Control the action of the shell on interrupts. The first form restores the default action 
of the shell on interrupts which is to terminate shell scripts or to return to the terminal 
command input level. The second form ‘onintr causes all interrupts to be ignored. 
The final form causes the shell to execute a ‘goto label’ when an interrupt is received or 
a child process terminates because it was interrupted. 

In any case, if the shell is running detached and interrupts are being ignored, all forms 
of onintr have no meaning and interrupts continue to be ignored by the shell and all 
invoked commands. 

popd 
popd -fn 

Pops the directory stack, returning to the new top directory. With a argument ‘-fn’ dis¬ 
cards the nth entry in the stack. The elements of the directory stack are numbered 
from 0 starting at the top. 

pushd 
pushd name 
pushd -fn 

With no arguments, pushd exchanges the top two elements of the directory stack. Given 
a name argument, pushd changes to the new directory (ala cd) and pushes the old 
current working directory (as in csw) onto the directory stack. With a numeric argu¬ 
ment, rotates the nth argument of the directory stack around to be the top element and 
changes to it. The members of the directory stack are numbered from the top starting 
at 0. 

rehash 

Causes the internal hash table of the contents of the directories in the path variable to 
be recomputed. This is needed if new commands are added to directories in the path 
while you are logged in. This should only be necessary if you add commands to one of 
your own directories, or if a systems programmer changes the contents of one of the sys¬ 
tem directories. 
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repeat count command 

The specified command which is subject to the same restrictions as the command in the 
one line 1 /statement above, is executed count times. I/O redirections occur exactly once, 
even if count is 0. 

set 

set name 
set name=word 
set name[index]=word 
set name=(wordlist) 

The first form of the command shows the value of all shell variables. Variables which 
have other than a single word as value print as a parenthesized word list. The second 
form sets name to the null string. The third form sets name to the single word. The 
fourth form sets the index’th component of name to word; this component must already 
exist. The final form sets name to the list of words in wordlist. In all cases the value is 
command and filename expanded. 

These arguments may be repeated to set multiple values in a single set command. Note 
however, that variable expansion happens for all arguments before any setting occurs. 

setenv name value 

Sets the value of environment variable name to be value, a single string. The most com¬ 
monly used environment variable USER, TERM, and PATH are automatically imported 
to and exported from the csh variables user, term, and path; there is no need to use 
setenv for these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argvflj. It is an error for argv not 
to be set or to have less than one word as value. The second form performs the same 
function on the specified variable. 

source name 
source -h name 

The shell reads commands from name. Source commands may be nested; if they are 
nested too deeply the shell may run out of file descriptors. An error in a source at any 
level terminates all nested source commands. Normally input during source commands 
is not placed on the history list; the -h option causes the commands to be placed in the 
history list without being executed. 

stop 

stop %job ... 

Stops the current or specified job which is executing in the background. 

suspend 

Causes the shell to stop in its tracks, much as if it had been sent a stop signal with *Z. 
This is most often used to stop shells started by su(l). 

switch (string) 
case strl: 


breaksw 

default: 
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breaksw 

endsw 

Each case label is successively matched, against the specified string which is first com¬ 
mand and filename expanded. The file metacharacters V, '?’ and '[...]’ may be used in 
the case labels, which are variable expanded. If none of the labels match before a 
‘default’ label is found, then the execution begins after the default label. Each case label 
and the default label must appear at the beginning of a line. The command breaksw 
causes execution to continue after the endsw. Otherwise control may fall through case 
labels and default labels as in C. If no label matches and there is no default, execution 
continues after the endsw. 

time 

time command 

With no argument, a summary of time used by this shell and its children is printed. If 
arguments are given the specified simple command is timed and a time summary as 
described under the time variable is printed. If necessary, an extra shell is created to 
print the time statistic when the command completes. 

umask 
umask value 

The file creation mask is displayed (first form) or set to the specified value (second 
form). The mask is given in octal. Common values for the mask are 002 giving all 
access to the group and read and execute access to others or 022 giving all access except 
no write access for users in the group or others. 

unalias pattern 

All aliases whose names match the specified pattern are discarded. Thus all aliases are 
removed by ‘unalias It is not an error for nothing to be unaliased. 

unhash 

Use of the internal hash table to speed location of executed programs is disabled. 

unlimit resource 
unlimit 

Removes the limitation on resource. If no resource is specified, then all resource limita¬ 
tions are removed. 

unset pattern 

All variables whose names match the specified pattern are removed. Thus all variables 
are removed by ‘unset this has noticeably distasteful side-effects. It is not an error 
for nothing to be unset. 

unsetenv pattern 

Removes all variables whose name match the specified pattern from the environment. 
See also the setenv command above and printenv(l). 

wait 

All background jobs are waited for. It the shell is interactive, then an interrupt can dis¬ 
rupt the wait, at which time the shell prints names and job numbers of all jobs known 
to be outstanding. 

while (expr) 

end 

While the specified expression evaluates non-zero, the commands between the while and 
the matching end are evaluated. Break and continue may be used to terminate or con¬ 
tinue the loop prematurely. (The while and end must appear alone on their input lines.) 
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Prompting occurs here the first time through the loop as for the foreach statement if the 
input is a terminal. 

%job 

Brings the specified job into the foreground. 

%}ob & 

Continues the specified job in the background. 

@ 

@ name = expr 
@ name[index] = expr 

The first form prints the values of all the shell variables. The second form sets the 
specified name to the value of expr. If the expression contains *<’, or ‘|’ then at 

least this part of the expression must be placed within ‘(’ ')’. The third form assigns the 
value of expr to the index’th argument of name. Both name and its index’th component 
must already exist. 

The operators ‘*=’, ‘+=’, etc are available as in C. The space separating the name 
from the assignment operator is optional. Spaces are, however, mandatory in separating 
components of expr which would otherwise be single words. 

Special postfix ‘+-t-’ and 1 —’ operators increment and decrement name respectively, i.e. 

i++\ 

Pre-Defined and Environment Variables 


The following variables have special meaning to the shell. Of these, argv, cwd, home, path, 
prompt, shell and status are always set by the shell. Except for cwd and status this setting 
occurs only at initialization; these variables will not then be modified unless this is done expli¬ 
citly by the user. 

This shell copies the environment variable USER into the variable user, TERM into term, and 
HOME into home, and copies these back into the environment whenever the normal shell vari¬ 
ables are reset. The environment variable PATH is likewise handled; it is not necessary to 
worry about its setting other than in the file .cshrc as inferior csh processes will import the 
definition of path from the environment, and re-export it if you then change it. 

argv Set to the arguments to the shell, it is from this variable that positional 

parameters are substituted, i.e. ‘$1’ is replaced by ‘$argv[l]’, etc. 

cdpath Gives a list of alternate directories searched to find subdirectories in chdir 

commands. 


cwd 

echo 


histchars 


history 


The full pathname of the current directory. 

Set when the -x command line option is given. Causes each command and 
its arguments to be echoed just before it is executed. For non-builtin com¬ 
mands all expansions occur before echoing. Builtin commands are echoed 
before command and filename substitution, since these substitutions are then 
done selectively. 

Can be given a string value to change the characters used in history substi¬ 
tution. The first character of its value is used as the history substitution 
character, replacing the default character !. The second character of its value 
replaces the character t in quick substitutions. 

Can be given a numeric value to control the size of the history list. Any 
command which has been referenced in this many events will not be dis¬ 
carded. Too large values of history may run the shell out of memory. The 
last executed command is always saved on the history list. 
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home 

ignoreeof 

mail 


noclobber 

noglob 

nonomatch 

notify 

path 


prompt 


savehist 


shell 


The home directory of the invoker, initialized from the environment. The 
filename expansion of ‘"’ refers to this variable. 

If set the shell ignores end-of-file from input devices which are terminals. 
This prevents shells from accidentally being killed by control-D’s. 

The files where the shell checks for mail. This is done after each command 
completion which will result in a prompt, if a specified interval has elapsed. 
The shell says ‘You have new mail.’ if the file exists with an access time not 
greater than its modify time. 

If the first word of the value of mail is numeric it specifies a different mail 
checking interval, in seconds, than the default, which is 10 minutes. 

If multiple mail files are specified, then the shell says ‘New mail in name ’ 
when there is mail in the file name. 

As described in the section on Input/output, restrictions are placed on output 
redirection to insure that files are not accidentally destroyed, and that ‘>>’ 
redirections refer to existing files. 

If set, filename expansion is inhibited. This is most useful in shell scripts 
which are not dealing with filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

If set, it is not an error for a filename expansion to not match any existing 
files; rather the primitive pattern is returned. It is still an error for the 
primitive pattern to be malformed, i.e. ‘echo [’ still gives an error. 

If set, the shell notifies asynchronously of job completions. The default is to 
rather present job completions just before printing a prompt. 

Each word of the path variable specifies a directory in which commands are 
to be sought for execution. A null word specifies the current directory. If 
there is no path variable then only full path names will execute. The usual 
search path is ‘/bin’ and ‘/usr/bin’, but this may vary from system to 
system. For the super-user the default search path is ‘/etc’, ‘/bin’ and 
‘/usr/bin’. A shell which is given neither the —c nor the —t option will nor¬ 
mally hash the contents of the directories in the path variable after reading 
.cshrc, and each time the path variable is reset. If new commands are added 
to these directories while the shell is active, it may be necessary to give the 
rehash or the commands may not be found. 

The string which is printed before each command is read from an interactive 
terminal input. If a T appears in the string it will be replaced by the 
current event number unless a preceding ‘\’ is given. Default is l % ’, or ‘# ’ 
for the super-user. 

is given a numeric value to control the number of entries of the history list 
that are saved in '/.history when the user logs out. Any command which 
has been referenced in this many events will be saved. During start up the 
shell sources '/.history into the history list enabling history to be saved 
across logins. Too large values of savehist will slow down the shell during 
start up. 

The file in which the shell resides. This is used in forking shells to interpret 
files which have execute bits set, but which are not executable by the system. 
(See the description of Non-builtin Command Execution below.) Initialized to 
the - (system-dependent) home of the shell. 
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status The status returned by the last command. If it terminated abnormally, then 

0200 is added to the status. Builtin commands which fail return exit status 
‘1’, all other builtin commands set status ‘O’. 

Controls automatic timing of commands. If set, then any command which 
takes more than this many cpu seconds will cause a line giving user, system, 
and real times and a utilization percentage which is the ratio of user plus 
system times to real time to be printed when it terminates. 

Set by the -v command line option, causes the words of each command to 
be printed after history substitution. 

Non-Built-In Command Execution 

When a command to be executed is found to not be a builtin command the shell attempts to 
execute the command via execve{ 2). Each word in the variable path names a directory from 
which the shell will attempt to execute the command. If it is given neither a — c nor a -t 
option, the shell will hash the names in these directories into an internal table so that it will 
only try an exec in a directory if there is a possibility that the command resides there. This 
greatly speeds command location when a large number of directories are present in the search 
path. If this mechanism has been turned off (via unhash), or if the shell was given a —c or -t 
argument, and in any case for each directory component of path which does not begin with a 
‘/’, the shell concatenates with the given command name to form a path name of a file which 
it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus ‘(cd ; pwd) ; pwd’ prints 
the home directory; leaving you where you w’ere (printing this after the home directory), while 
‘cd ; pwd’ leaves you in the home directory. Parenthesized commands are most often used to 
prevent chdir from affecting the current shell. 

If the file has execute permissions but is not an executable binary to the system, then it is 
assumed to be a file containing shell commands and a new shell is spawned to read it. 

If there is an alias for shell then the words of the alias will be prepended to the argument list 
to form the shell command. The first word of the alias should be the full path name of the 
shell (e.g. ‘Sshell’). Note that this is a special, late occurring, case of alias substitution, and 
only allows words to be prepended to the argument list without modification. 

Argument List Processing 

If argument 0 to the shell is then this is a login shell. The flag arguments are interpreted 
as follows: 

-c Commands are read from the (single) following argument which must be present. Any 
remaining arguments are placed in argv. 

—e The shell exits if any invoked command terminates abnormally or yields a non-zero exit 

status. 

-f The shell will start faster, because it will neither search for nor execute commands from 
the file ‘.cshrc’ in the invokers home directory. 

—i The shell is interactive and prompts for its top-level input, even if it appears to not be a 

terminal. Shells are interactive without this option if their inputs and outputs are ter¬ 
minals. 

—n Commands are parsed, but not executed. This aids in syntactic checking of shell scripts. 
—s Command input is taken from the standard input. 

-t A single line of input is read and executed. A ‘\’ may be used to escape the newline at 
the end of this line and continue onto another line. 


time 


verbose 
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—v Causes the verbose variable to be set, with the effect that command input is echoed after 
history substitution. 

—x Causes the echo variable to be set, so that commands are echoed immediately before exe¬ 
cution. 

—V Causes the verbose variable to be set even before ‘.cshrc’ is executed. 

-X Is to —x as -V is to -v. 

After processing of flag arguments if arguments remain but none of the -c, —i, -s, or -t 
options was given the first argument is taken as the name of a file of commands to be exe¬ 
cuted. The shell opens this file, and saves its name for possible resubstitution by ‘$0’. Since 
many systems use either the standard version 6 or version 7 shells whose shell scripts are not 
compatible with this shell, the shell will execute such a ‘standard’ shell if the first character of 
a script is not a i.e. if the script does not start with a comment. Remaining arguments 
initialize the variable argv. 

Signal Handling 

The shell normally ignores quit signals. Jobs running detached (either by or the bg or %... 
& commands) are immune to signals generated from the keyboard, including hangups. Other 
signals have the values which the shell inherited from its parent. The shells handling of inter¬ 
rupts and terminate signals in shell scripts can be controlled by onintr. Login shells catch the 
terminate signal; otherwise this signal is passed on to children from the state in the shell’s 
parent. In no case are interrupts allowed when a login shell is reading the file ‘.logout’. 

AUTHOR 

William Joy. Job control and directory stack features first implemented by J.E. Kulp of 
I.I.A.S.A, Laxenburg, Austria, with different syntax than that used now. 


FILES 

"/.cshrc 

"/■login 

"/.logout 

/bin/sh 

/tmp/sh* 

/etc/passwd 


Read at beginning of execution by each shell. 
Read by login shell, after ‘.cshrc’ at login. 
Read by login shell, at logout. 

Standard shell, for shell scripts not starting 
with a *#’. 

Temporary file for *<<’. 

Source of home directories for ‘"name’. 


LIMITATIONS 

Words can be no longer than 1024 characters. The system limits argument lists to 10240 
characters. The number of arguments to a command which involves filename expansion is 
limited to 1/6’th the number of characters allowed in an argument list. Command substitu¬ 
tions may substitute no more characters than are allowed in an argument list. To detect 
looping, the shell restricts the number of alias substitutions on a single line to 20. 


SEE ALSO 

sh(l), access(2), execve(2), fork(2), killpg(2), pipe(2), sigvec(2), umask(2), setrlimit(2), wait(2), 
tty(4), a.out(5), environ(7), ‘An introduction to the C shell’ 
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BUGS 

When a command is restarted from a stop, the shell prints the directory it started in if this is 
different from the current directory; this can be misleading (i.e. wrong) as the job may have 
changed directories internally. 

Shell builtin functions are not stoppable/restartable. Command sequences of the form ‘a ; b ; 
c’ are also not handled gracefully when stopping is attempted. If you suspend ‘b’, the shell 
will then immediately execute ‘c’. This is especially noticeable if this expansion results from 
an alias. It suffices to place the sequence of commands in ()’s to force it to a subshell, i.e. ‘( a ; 
b ; c )’. 

Control over tty output after processes are started is primitive; perhaps this will inspire some¬ 
one to work on a good virtual terminal interface. In a virtual terminal interface much more 
interesting things could be done with output control. 

Alias substitution is most often used to clumsily simulate shell procedures; shell procedures 
should be provided rather than aliases. 

Commands within loops, prompted for by '?’, are not placed in the history list. Control struc¬ 
ture should be parsed rather than being recognized as built-in commands. This would allow 
control commands to be placed anywhere, to be combined with ‘|’, and to be used with 
and ';’ metasyntax. 

It should be possible to use the modifiers on the output of command substitutions. All and 
more than one V modifier should be allowed on '$’ substitutions. 

Symbolic links fool the shell. In particular, dirs and ‘cd ..’ don’t work properly once you’ve 
crossed through a symbolic link. 
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NAME 

ctags - create a tags file 

SYNOPSIS 

ctags [ —BFatuwvx ] name ... 

DESCRIPTION 

Ctags makes a tags file for e*(l) from the specified C, Pascal and Fortran sources. A tags file 
gives the locations of specified objects (in this case functions and typedefs) in a group of files. 
Each line of the tags file contains the object name, the file in which it is defined, and an 
address specification for the object definition. Functions are searched with a pattern, typedefs 
with a line number. Specifiers are given in separate fields on the line, separated by blanks or 
tabs. Using the tags file, ex can quickly find these objects definitions. 

If the —x flag is given, ctags produces a list of object names, the line number and file name on 
which each is defined, as well as the text of that line and prints this on the standard output. 
This is a simple index which can be printed out as an off-line readable function index. 

If the —v flag is given, an index of the form expected by vgrind{\) is produced on the standard 
output. This listing contains the function name, file name, and page number (assuming 64 
line pages). Since the output will be sorted into lexicographic order, it may be desired to run 
the output through sort -f. Sample use: 
ctags -v files | sort -f > index 
vgrind -x index 

Files whose name ends in .c or Ji are assumed to be C source files and are searched for C rou¬ 
tine and macro definitions. Others are first examined to see if they contain any Pascal or For¬ 
tran routine definitions; if not, they are processed again looking for C definitions. 

Other options are: 

—F use forward searching patterns (/.../) (default). 

-B use backward searching patterns (?...?). 

-a append to tags file. 

—t create tags for typedefs. 

-w suppressing warning diagnostics. 

—u causing the specified files to be updated in tags, that is, all references to them are 

deleted, and the new values are appended to the file. (Beware: this option is imple¬ 
mented in a way which is rather slow, it is usually faster to simply rebuild the tags file.) 

The tag main is treated specially in C programs. The tag formed is created by prepending M 
to the name of the file, with a trailing .c removed, if any, and leading pathname components 
also removed. This makes use of ctags practical in directories with more than one program. 


FILES 

tags output tags file 

SEE ALSO 

ex(l), vi(l) 

AUTHOR 

Ken Arnold; FORTRAN added by Jim Ivleckner; Bill Joy added Pascal and —x, replacing 
cxref; C typedefs added by Ed Pelegri-Llopart. 
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BUGS 

Recognition of functions, subroutines and procedures for FORTRAN and Pascal is done 
is a very simpleminded way. No attempt is made to deal with block structure; if you have 
two Pascal procedures in different blocks with the same name you lose. 

The method of deciding whether to look for C or Pascal and FORTRAN functions is a hack. 
Does not know about #ifdefs. 

Should know about Pascal types. Relies on the input being well formed to detect typedefs. 
Use of -tx shows only the last line of typedefs. 
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NAME 

date - print and set the date 

SYNOPSIS 

date [-z zone] [-d dst] [ -u ] [ yymmddhhmm [ jss ] ] 

DESCRIPTION 

If no arguments are given, the current date and time are printed. If a date is specified, the 
current date is set. The -z flag is used to set your local timezone. Timezone is specified in 
minutes west of Greenwich, England. Thus eastern timezone would be specifed -z 800 and 
pacific time would be specified -z 480 . The -d flag is used to set the type of daylight savings 
correction to be applied if any. No correction would be specified -d 0 and standard USA style 
correction would be specified -d 1 . The -u flag is used to display the date in GMT (universal) 
time. This flag may also be used to set GMT time, yy is the last two digits of the year; the 
first mm is the month number; dd is the day number in the month; hh is the hour number (24 
hour system); the second mm is the minute number; .ss is optional and is the seconds. For 
example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The year, month and day may be omitted, the current 
values being the defaults. The system operates in GMT. Date takes care of the conversion to 
and from local standard and daylight time. 


FILES 

/usr/adm/wtmp to record time-setting 

/etc/rc.local to set default timezone and dst flag at boot time 

SEE ALSO 

utmp(5) 

DIAGNOSTICS 

‘Failed to set date: Not owner’ if you try to change the date but are not the super-user. 
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NAME 

dbx - debugger 

SYNOPSIS 

dbx [ — r ] [ —i ] [ —I dir ] [ objfile [ coredump ]] 

DESCRIPTION 

Dbx is a tool for source level debugging and execution of programs under UNIX. The objfile is 
an object file produced by a compiler with the appropriate flag (usually “-g”) specified to pro¬ 
duce symbol information in the object file. Currently, ec(l) and /77(1) produce the appropri¬ 
ate source information and it is expected that in the future the Pascal compiler will also be 
able to generate source level information. The machine level facilities of dbx can be used on 
any program. 

If no objfile is specified, dbx looks for a file named “a.out” in the current directory. The 
object file contains a symbol table which includes the name of the all the source files 
translated by the compiler to create it. These files are available for perusal while using the 
debugger. 

If a file named “core” exists in the current directory or a coredump file is specified, dbx can be 
used to examine the state of the program when it faulted. 

If the file “.dbxinit” exists in the current directory then the debugger commands in it are exe¬ 
cuted. Dbx also checks for a “.dbxinit” in the user’s home directory if there isn’t one in the 
current directory. 

The command line options and their meanings are: 

—r Execute objfile immediately. If it terminates successfully dbx exits. Otherwise the rea¬ 
son for termination will be reported and the user offered the option of entering the 
debugger or letting the program fault. Dbx will read from “/dev/tty” when -r is 
specified and standard input is not a terminal. 

-i Force dbx to act as though standard input is a terminal. 

—I dir Add dir to the list of directories that are searched when looking for a source file. Nor¬ 
mally dbx looks for source files in the current directory and in the directory where 
objfile is located. The directory search path can also be set with the use command. 

Unless -r is specified, dbx just prompts and waits for a command. 

Execution and Tracing Commands 
run [ar< 7 s] [< filename ] [> filename] 

Start executing objfile, passing args as command line arguments; < or > can be used 
to redirect input or output in the usual manner. If objfile has been written since the 
last time the symbolic information was read in, dbx will read in the new information. 

trace [in procedure!function] [if condition] 
trace source-line-number [if condition] 

trace procedure!function [in procedure/function] [if condition] 
trace expression at source-line-number [if condition] 
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trace variable [in procedure/function] [if condition] 

Have tracing information printed when the program is executed. A number is associ¬ 
ated with the command that is used to turn the tracing off (see the delete command). 

The first argument describes what is to be traced. If it is a source-line-number, then 
the line is printed immediately prior to being executed. Source line numbers in a file 
other than the current one must be preceded by the name of the file in quotes and a 
colon, e.g. "mumble.p":17. 

If the argument is a procedure or function name then every time it is called, informar 
tion is printed telling what routine called it, from what source line it was called, and 
what parameters were passed to it. In addition, its return is noted, and if it’s a func¬ 
tion then the value it is returning is also printed. 

If the argument is an expression with an at clause then the value of the expression is 
printed whenever the identified source line is reached. 

If the argument is a variable then the name and value of the variable is printed when¬ 
ever it changes. Execution is substantially slower during this form of tracing. 

If no argument is specified then all source lines are printed before they are executed. 
Execution is substantially slower during this form of tracing. 

The clause “in procedure)function” restricts tracing information to be printed only 
while executing inside the given procedure or function. 

Condition is a boolean expression and is evaluated prior to printing the tracing infor¬ 
mation; if it is false then the information is not printed. 

stop if condition 

stop at source-line-number [if condition] 
stop in procedure/function [if condition] 
stop variable [if condition] 

Stop execution when the given line is reached, procedure or function called, variable 
changed, or condition true. 

status [> filename] 

Print out the currently active trace and stop commands, 
delete command-number 

The trace or stop corresponding to the given number is removed. The numbers associ¬ 
ated with traces and stops are printed by the status command. 

catch number 
ignore number 

Start or stop trapping signal number before it is sent to the program. This is useful 
when a program being debugged handles signals such as interrupts. Initially all signals 
are trapped except SIGCONT, SIGCHILD, SIGALRM and SIGKILL. 

cont Continue execution from where it stopped. Execution cannot be continued if the 
process has “finished”, that is, called the standard procedure “exit”. Dbx does not 
allow the process to exit, thereby letting the user to examine the program state. 

step Execute one source line. 
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next Execute up to the next source line. The difference between this and step is that if the 
line contains a call to a procedure or function the step command will stop at the 
beginning of that block, while the next command will not. 

Displaying and Naming Data 

print expression [, expression ...] 

Print out the values of the expressions. Array expressions are always subscripted by 
brackets (“[ ]”). Variables having the same identifier as one in the current block may 
be referenced as “ block-name . variable ”. The field reference operator (“.”) can be used 
with pointers as well as records, making the C operator unnecessary (although it 

is supported). The construct typenamefexpression ) can be used to print the expression 
out in the format of the named type. 

whatis name 

Print the declaration of the given name, which may be qualified with block names as 
above. 

which identifier 

Print the full qualification of the given identifer, i.e. the outer blocks that the 
identifier is associated with. 

whereis identifier 

Print the full qualification of all the symbols whose name matches the given identifier. 
The order in which the symbols are printed is not meaningful. 

assign variable — expression 
set variable = expression 

Assign the value of the expression to the variable. 

call procedure(parameters) 

Execute the object code associated with the named procedure or function. Currently, 
calls to a procedure with a variable number of arguments are not possible. Also, 
string parameters are not passed properly for C. 

where Print out a list of the active procedures and function, 
dump [> filename ] 

Print the names and values of all active variables. 

Accessing Source Files 
edit [filename] 

edit procedure!function-name 

Invoke an editor on filename or the current source file if none is specified. If a pro¬ 
cedure or function name is specified, the editor is invoked on the file that contains it. 
Which editor is invoked by default depends on the installation. The default can be 
overridden by setting the environment variable EDITOR to the name of the desired 
editor. 

file [filename] 

Change the current source file name to filename. If none is specified then the current 
source file name is printed. 


ICON INTERNATIONAL 


3 





DBX(l) 


USER COMMANDS 


DBX(l) 


func [ procedure/function ] 

Change the current function. If none is specified then print the current function. 
Changing the current function implicitly changes the current source file to the one 
that contains the function; it also changes the current scope used for name resolution. 

list [ source-line-number [, source-line-number]} 
list procedure/function 

List the lines in the current source file from the first line number to the second 
inclusive. If no lines are specified, the next 10 lines are listed. If the name of a pro¬ 
cedure or function is given lines n-k to n+k are listed where n is the first statement in 
the procedure or function and k is small. 

use directory-list 

Set the list of directories to be searched when looking for source files. 

Machine Level Commands 

tracei address ] [if cond] 
tracei [variable) [at address] [if cond] 
stopi address] [if cond] 
stopi [at] [address] [if cond] 

Turn on tracing or set a stop using a machine instruction address. 

stepi 

nexti Single step as in step or next, but do a single instruction rather than source line. 

address t address{ [mode] 

[ address ] / [count] [mode] 

Print the contents of memory starting at the first address and continuing up to the 
second address or until count items are printed. If no address is specified, the address 
following the one printed most recently is used. The mode specifies how memory is to 
be printed; if it is omitted the previous mode specified is used. The initial mode is 
“X”. The following modes are supported: 

i print the machine instruction 

d print a short word in decimal 

D print a long word in decimal 

o print a short word in octal 

O print a long word in octal 

x print a short word in hexadecimal 

X print a long word in hexadecimal 

b print a byte in octal 

c print a byte as a character 

s print a string of characters terminated by a null byte 

f print a single precision real number 

g print a double precision real number 

Symbolic addresses are specified by preceding the name with an Registers are denoted 

by, “$dN” where N is the number of a data register, and “$aN” where N is the number of an 
address register. Addresses may be expressions made up of other addresses and the operators 
“+”, and indirection (unary 
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Miscellaneous Commands 
sh command-line 

Pass the command line to the shell for execution. The SHELL environment variable 
determines which shell is used. 

alias new-command-name old-command-name 

Respond to new-command-name as though it were old-command-name. 

help Print out a synopsis of dbx commands. 

gripe Invoke a mail program to send a message to the person in charge of dbx. 
source filename 

Read dbx commands from the given filename. Especially useful when the filename has 
been created by redirecting a status command from an earlier debugging session. 

quit Exit dbx. 


FILES 

a.out object file 

.dbxinit initial commands 

SEE ALSO 

cc(l), 177(1), pc(l) 

COMMENTS 

Non-local gotos can cause some trace/stops to be missed. Most of the command names are 
too long. The alias facility helps, but is really quite weak. A csh -like history capability would 
improve the situation. But then, who wants to duplicate the c-shell in a debugger? 

Dbx suffers from the same “multiple include” malady as does sdb. If you have a program con¬ 
sisting of a number of object files and each is built from source files that include header files, 
the symbolic information for the header files is replicated in each object file. Since about one 
debugger start-up is done for each link, having the linker (Id) re-organize the symbol informa¬ 
tion won’t save much time, though it would reduce some of the disk space used. The problem 
is an artifact of the unrestricted semantics of #include’s in C; for example an include file can 
contain static declarations that are separate entities for each file in which they are included. 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, 
but one may specify an input base, output base, and a number of fractional digits to be main¬ 
tained. The overall structure of dc is a stacking (reverse Polish) calculator. If an argument is 
given, input is taken from that file until its end, then from the standard input. The following 
constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken string of 
the digits 0-9. It may be preceded by an underscore _ to input a negative number. 
Numbers may contain decimal points. 

+ -/*%“ 

The top two values on the stack are added (+), subtracted (-), multiplied (*), divided 
(/), remaindered (%), or exponentiated ("). The two entries are popped off the stack; 
the result is pushed on the stack in their place. Any fractional part of an exponent is 
ignored. 

sx The top of the stack is popped and stored into a register named x, where x may be any 
character. If the s is capitalized, x is treated as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is not altered. All regis¬ 
ters start with zero value. If the 1 is capitalized, register x is treated as a stack and its 
top value is popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. P interprets 

the top of the stack as an ascii string, removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is 
capitalized, the top value on the stack is popped and the string execution level is 
popped by that value. 

x treats the top element of the stack as a character string and executes it as a string of 
dc commands. 

X replaces the number on the top of the stack with its scale factor. 

[... ] puts the bracketed ascii string onto the top of the stack. 

<x >x =z 

The top two elements of the stack are popped and compared. Register x is executed if 
they obey the stated relation. 

v replaces the top element on the stack by its square root. Any existing fractional part 
of the argument is taken into account, but otherwise the scale factor is ignored. 

! interprets the rest of the line as a UNIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix for further input. 
I pushes the input base on the top of the stack. 
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o The top value on the stack is popped and used as the number radix for further output. 
O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non-negative scale factor: 

the appropriate number of places are printed on output, and maintained during multi¬ 
plication, division, and exponentiation. The interaction of scale factor, input base, and 
output base will be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) and executed. 

; : are used by be for array operations. 

An example which prints the first ten values of n! is 

[lal -fdsa*plalO> y]sy 

Osal 

lyx 


SEE ALSO 

bc(l), which is a preprocessor for dc providing infix notation and a C-like syntax which imple¬ 
ments functions and reasonable control structures for programs. 

DIAGNOSTICS 

‘x is unimplemented’ where x is an octal number. 

‘stack empty’ for not enough elements on the stack to do what was asked. 

‘Out of space’ when the free list is exhausted (too many digits). 

‘Out. of headers’ for too many numbers being kept around. 

‘Out of pushdown’ for too many items on the stack. 

‘Nesting Depth’ for too many levels of nested execution. 
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NAME 

dd - convert and copy a file 


SYNOPSIS 

dd [op t ion=value] ... 


DESCRIPTION 

Dd copies the specified input file to the specified output with possible conversions. The stan¬ 
dard input and output are used by default. The input and output block size may be specified 
to take advantage of raw physical I/O. 


option 
if— 
of= 
ibs=n 
obs— n 
bs —n 

cbs =n 

skip=n 

files=n 

seek=n 

count=n 

conv=ascii 

ebcdic 

ibm 

block 

unblock 

lease 

ucase 

swab 

noerror 

sync 


values 

input file name; standard input is default 
output file name; standard output is default 
input block size n bytes (default 512) 
output block size (default 512) 

set both input and output block size, superseding ibs and obs; also, if no 
conversion is specified, it is particularly efficient since no copy need be done 
conversion buffer size 
skip n input records before starting copy 

copy n input files before terminating (makes sense only where input is a 
magtape or similar device). 

seek n records from beginning of output file before copying 

copy only n input records 

convert EBCDIC to ASCII 

convert ASCII to EBCDIC 

slightly different map of ASCII to EBCDIC 

convert variable length records to fixed length 

convert fixed length records to variable length 

map alphabetics to lower case 

map alphabetics to upper case 

swap every pair of bytes 

do not stop processing on an error 

pad every input record to ibs 

several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k, b or w 
to specify multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated 
by x to indicate a product. 


Cbs is used only if ascii, unblock, ebcdic, ibm, or block conversion is specified. In the first two 
cases, cbs characters are placed into the conversion buffer, any specified character mapping is 
done, trailing blanks trimmed and new-line added before sending the line to the output. In 
the latter three cases, characters are read into the conversion buffer, and blanks added to 
make up an output record of size cbs. 


After completion, dd reports the number of whole and partial input and output blocks. 

For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record 
into the ASCII file x: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 \ 
conv= ascii, lease 
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Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices 
because it allows reading and writing in arbitrary record sizes. 

* 

SEE ALSO 

cp(l), tr(l) 

DIAGNOSTICS 

f-f-p records in(out): numbers of full and partial records read(written) 


BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the 
CACM Nov, 1968. The ‘ibm’ conversion, while less blessed as a standard, corresponds better 
to certain IBM print train conventions. There is no universal solution. 

One must specify “conv=noerror,sync” when copying raw disks with bad sectors to insure dd 
stays synchronized. 
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NAME 

deroff - remove nroff, troff, tbl and eqn constructs 

SYNOPSIS 

deroff [ -w ] file ... 

DESCRIPTION 

Deroff reads each file in sequence and removes all nroff and troff command lines, backslash 
constructions, macro definitions, eqn constructs (between ‘.EQ’ and ‘.EN’ lines or between del¬ 
imiters), and table descriptions and writes the remainder on the standard output. Deroff fol¬ 
lows chains of included files (‘.so’ and ‘.nx’ commands); if a file has already been included, a 
‘.so’ is ignored and a ‘.nx’ terminates execution. If no input file is given, deroff reads from the 
standard input file. 

If the —w flag is given, the output is a word list, one ‘word’ (string of letters, digits, and apos¬ 
trophes, beginning with a letter; apostrophes are removed) per line, and all other characters 
ignored. Otherwise, the output follows the original, with the deletions mentioned above. 

SEE ALSO 

troff(l), eqn(l), tbl(l) 


BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most 
errors result in too much rather than too little output. 
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NAME 

df - disk free 


SYNOPSIS 

df [ -i ] [ filesystem ... ] [ file ... ] 

DESCRIPTION 

DJ prints out the amount of free disk space available on the specified filesystem, e.g. 
“/dev/scOa”, or on the filesystem in which the specified file, e.g. “SHOME”, is contained. If 
no file system is specified, the free space on all of the normally mounted file systems is 
printed. The reported numbers are in kilobytes. 

Other options are: 

—i Report also the number of inodes which are used. 


FILES 

/etc/fstab list of normally mounted filesystems 


SEE ALSO 

fstab(5), quot(8) 
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NAME 

diction .explain - print wordy sentences; thesaurus for diction 
SYNOPSIS 

diction [ —ml ] [ -mm ] [ -n ] [ —f pfile ] file ... 
explain 

DESCRIPTION 

Diction finds all sentences in a document that contain phrases from a data base of bad or 
wordy diction. Each phrase is bracketed with [ ]. Because diction runs deroff before looking 
at the text, formatting header files should be included as part of the input. The default 
macro package —ms may be overridden with the flag —mm. The flag —ml which causes deroff 
to skip lists, should be used if the document contains many lists of non-sentences. The user 
may supply her/his own pattern file to be used in addition to the default file with -f pfile. If 
the flag —n is also supplied the default file will be suppressed. 

Explain is an interactive thesaurus for the phrases found by diction. 

SEE ALSO 

deroff(l) 


BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, 
diction doesn’t grok -me. 
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NAME 

diff - differential file and directory comparator 


SYNOPSIS 

diff 

diff 

diff 


~1 ] [ -r ] [ —8 ] I — 1 cefh ] [ — b ] dirl dir2 
—cefh ] [ -b ] filel file2 
-D string j [ —b ] filel fiie2 


DESCRIPTION 

If both arguments are directories, diff sorts the contents of the directories by name, and then 
runs the regular file diff algorithm (described below) on text files which are different. Binary 
files which differ, common subdirectories, and files which appear in only one directory are 
listed. Options when comparing directories are: 

—1 long output format; each text file diff is piped through pr(l) to paginate it, other 
differences are remembered and summarized after all text file differences are reported. 

—r causes application of diff recursively to common subdirectories encountered. 

—s causes diff to report files which are the same, which are otherwise not mentioned. 

—Sname 

starts a directory diff in the middle beginning with file name. 

When run on regular files, and w r hen comparing text files which differ during directory com¬ 
parison, diff tells what lines must be changed in the files to bring them into agreement. 
Except in rare circumstances, diff finds a smallest sufficient set of file differences. If neither 
filel nor file2 is a directory, then either may be given as in which case the standard input 
is used. If filel is a directory, then a file in that directory whose file-name is the same as the 
file-name of fileS is used (and vice versa). 

There are several options for output format; the default output format contains lines of these 
forms: 

nl a nS.nj 
nl,n2 d nS 
nl,n2 c nS,n4 

These lines resemble ed commands to convert filel into file2. The numbers after the letters 
pertain to file2. In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertain 
equally how to convert file2 into filel. As in ed, identical pairs where nl — n2 or nS — n4 
are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by *<’, 
then all the lines that are affected in the second file flagged by “>’. 

Except for -b, which may be given with any of the others, the following options are mutually 
exclusive: 

—e producing a script of a, c and d commands for the editor ed, which will recreate 

file2 from filel. In connection with —e, the following shell program may help main¬ 
tain multiple versions of a file. Only an ancestral file ($1) and a chain of version- 
to-version ed scripts ($2,$3,...) made by diff need be on hand. A ‘latest version’ 
appears on the standard output. 

(shift; cat $*; echo T,$p') J ed - $1 

Extra commands are added to the output when comparing directories with —e, so 
that the result is a sh( l) script for converting text files which are common to the 
two directories from their state in dirl to their state in dir2. 
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—f produces a script similar to that of -e, not useful with ed, and in the opposite 

order. 

—c produces a diff with lines of context. The default is to present 3 lines of context 

and may be changed, e.g to 10, by —clO. With —c the output format is modified 
slightly: the output beginning with identification of the files involved and their crea¬ 
tion dates and then each change is separated by a line with a dozen *’s. The lines 
removed from filel are marked with those added to fileS are marked '+’. Lines 
which are changed from one file to the other are marked in both files with ‘!\ 

—h does a fast, half-hearted job. It works only when changed stretches are short and 

well separated, but does work on files of unlimited length. 

—Dstring 

causes diff to create a merged version of filel and fileS on the standard output, with 
C preprocessor controls included so that a compilation of the result without 
defining string is equivalent to compiling filel, while defining string will yield fileS. 

-b causes trailing blanks (spaces and tabs) to be ignored, and other strings of blanks to 

compare equal. 

FILES 

/tmp/d????? 

/usr/lib/diffh for —h 
/bin/pr 

SEE ALSO 

cmp(l), cc(l), comm(l), ed(l), diff3(l) 

DIAGNOSTICS 

Exit status is 0 for no differences, 1 for some, 2 for trouble. 

BUGS 

Editing scripts produced under the -e or -f option are naive about creating lines consisting of 
a single 

When comparing directories with the -b option specified, diff first compares the files ala cmp, 
and then decides to run the diff algorithm if they are not equal. This may cause a small 
amount of spurious output if the files then turn out to be identical because the only 
differences are insignificant blank string differences. 
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NAME 

diff3 - 3-way differential file comparison 

SYNOPSIS 

difF3 [ —ex3 ] filel file2 file3 
DESCRIPTION 

DiffS compares three versions of a file, and publishes disagreeing ranges of text flagged with 
these codes: 

===== all three files differ 

====1 filel is different 

====2 fileS is different 

====3 fileS is different 

The type of change suffered in converting a given range of a given file to some other is indi¬ 
cated in one of these ways: 

/ : nl a Text is to be appended after line number nl in file /, where /= 1, 2, or 3. 

f: nl , nS c Text is to be changed in the range line nl to line nS. If nl = n2, the range 

may be abbreviated to nl. 

The original contents of the range follows immediately after a c indication. When the con¬ 
tents of two files are identical, the contents of the lower-numbered file is suppressed. 

Under the —e option, diffS publishes a script for the editor ed that will incorporate into filel 
all changes between fileS and fileS, i.e. the changes that normally would be flagged ===== 
and ====3. Option -x (-3) produces a script to incorporate only changes flagged 
==== (====3). The following command will apply the resulting script to ‘filel’. 

(cat script; echo T,$p') | ed - filel 


FILES 

/tmp/d3????? 

/usr/lib/diff3 


SEE ALSO 

diff(l) 


BUGS 

Text lines that consist of a single will defeat —e. 
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NAME 

dis - an mc68020 disassembler 

SYNOPSIS 

dis file ... 

DESCRIPTION 

The dis command produces an assembly language listing of each of its object file arguments. 
The listing includes assembly statements and the hexadecimal objects that produced those 
statements. 

SEE ALSO 

as(l), cc( 1), ld(l). 
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NAME 

dose - connect to proc/286 system 

SYNOPSIS 

dose [ partition ] 

DESCRIPTION 

Dose is used to connect to one of the Multi-Link partitions. The optional partition parameter 
may be specified to access a specific partition. If no partition is specified, the command will 
attempt to-find an available partition and connect to it. If the terminal type is dtlSOO or 
peshad, the terminal will be switched to make-break mode. Multi-Link must be configured 
properly to correspond to the terminal currently in use. 

The total number of active partitions is set in the file /etc/mttys. If /etc/mttys does not 
exist dose will attempt to access up to 8 partitions. If dose is unable to access a partition, a 
message is printed and an exit status of 10 (decimal) is returned. A shell script could be 
implemented to wait for a partition to become available. 

There are two commands that are responded to by the dose program: exit and suspend. For 
non-PC-compatible terminals, exit is signaled with A \, and suspend with ']. For PC- 
compatible terminals, exit is CONTROL-ALT-\, and suspend is CONTROL-ALT-]. Exit 
disconnects and relinquishes the partition. Subsequent uses of the dose command will re-use 
the partition and the Multi-Link session will be as it was when the exit was done. Suspend, 
on the other hand, disconnects but does not relinquish the partition. After other activities, 
the Multi-Link session can be resumed by using the fg command of csh(l). No other dose 
users can access the partition until an exit command is given. 

Make sure when entering the multiple key sequences that the CONTROL and ALT keys are 
fully down before the \ or ] is pressed. Failing to do this can result in spurious characters 
being sent to the Multi-link session. 

If the screen gets overwritten with system messages it can be re-painted by issuing ALT-r 
(from PC-compatible terminals) or ESC-b (from normal terminals). 


FILES 

/usr/spool/uucp/LCK..mtty, /dev/mtty, /etc/mttys 

SEE ALSO 

csh(l) (for fg command), whodos(l) 

NOTE 

If a dose process is terminated other than by exit, it will leave a lock file in /usr/spool/uucp. 
This file must be deleted before the partition can be re-used. 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ — s ] [ —a ] [ name ... ] 


DESCRIPTION 

Du gives the number of kilobytes contained in all files and, recursively, directories within each 
specified directory or file name. If name is missing, V is used. 

The argument -s causes only the grand total to be given. The argument -a causes an entry 
to be generated for each file. Absence of either causes an entry to be generated for each direc¬ 
tory only. 

A file which has two links to it is only counted once. 


SEE ALSO 

df(l), quot(8) 



BUGS 

Non-directories given as arguments (not under -a option) are not listed. 

If there are too many distinct linked files, du counts the excess files multiply. 


/f 
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NAME 

echo - echo arguments 

SYNOPSIS 

echo [ — n ] [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a newline on the standard 
output. If the flag -n is used, no newline is added to the output. 

Echo is useful for producing diagnostics in shell programs and for writing constant data on 
pipes. To send diagnostics to the standard error file, do ‘echo ... 1>&2\ 
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NAME 

ed - text editor 

SYNOPSIS 

e d [ — ] [ —x ] [ name ] 

DESCRIPTION 

Ed is the standard text editor. 

If a name argument is given, ed simulates an e command (see below) on the named file; that 
is to say, the file is read into ed’s buffer so that it can be edited. If —x is present, an x com¬ 
mand is simulated first to handle an encrypted file. The optional - suppresses the printing of 
explanatory output and should be used when the standard input is an editor script. 

Ed operates on a copy of any file it is editing; changes made in the copy have no effect on the 
file until a w (write) command is given. The copy of the text being edited resides in a tem¬ 
porary file called the buffer. 

Commands to ed have a simple and regular structure: zero or more addresses followed by a 
single character command, possibly followed by parameters to the command. These addresses 
specify one or more lines in the buffer. Missing addresses are supplied by default. 

In general, only one command may appear on a line. Certain commands allow the addition of 
text to the buffer. While ed is accepting text, it is said to be in input mode. In this mode, no 
commands are recognized; all input is merely collected. Input mode is left by typing a period 
V alone at the beginning of a line. 

Ed supports a limited form of regular expression notation. A regular expression specifies a set 
of strings of characters. A member of this set of strings is said to be matched by the regular 
expression. In the following specification for regular expressions the word ‘character’ means 
any character but newline. 

1. Any character except a special character matches itself. Special characters are the reg¬ 
ular expression delimiter plus \[. and sometimes A *$. 

2. A . matches any character. 

3. A \ followed by any character except a digit or () matches that character. 

4. A nonempty string s bracketed j s ] (or [ A s]) matches any character in (or not in) s. In 

s, \ has no special meaning, and ] may only appear as the first letter. A substring a-b, 
with a and b in ascending ASCII order, stands for the inclusive range of ASCII charac¬ 
ters. 

5. A regular expression of form 1-4 followed by * matches a sequence of 0 or more 
matches of the regular expression. 

6. A regular expression, x, of form 1-8, bracketed \( a: \) matches what x matches. 

7. A \ followed by a digit n matches a copy of the string that the bracketed regular 

expression beginning with the nth \( matched. 

8. A regular expression of form 1-8, x, followed by a regular expression of form 1-7, y 
matches a match for x followed by a match for y, with the x match being as long as 
possible while still permitting a y match. 

9. A regular expression of form 1-8 preceded by A (or followed by $), is constrained to 
matches that begin at the left (or end at the right) end of a line. 

10. A regular expression of form 1-9 picks out the longest among the leftmost matches in 
a line. 
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11. An empty regular expression stands for a copy of the last regular expression encoun¬ 
tered. 

Regular expressions are used in addresses to specify lines and in one command (see s below) to 
specify a portion of a line which is to be replaced. If it is desired to use one of the regular 
expression metacharacters as an ordinary character, that character may be preceded by ‘\\ 
This also applies to the character bounding the regular expression (often ‘/’) and to l \ itself. 

To understand addressing in ed it is necessary to know that at any time there is a current 
line. Generally speaking, the current line is the last line affected by a command; however, the 
exact effect on the current line is discussed under the description of the command. Addresses 
are constructed as follows. 

1. The character V addresses the current line. 

2. The character *$’ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. " x ’ addresses the line marked with the name x, which must be a lower-case letter. 
Lines are marked with the k command described below. 

5. A regular expression enclosed in slashes addresses the line found by searching for¬ 
ward from the current line and stopping at the first line containing a string that 
matches the regular expression. If necessary the search wraps around to the beginning 
of the buffer. 

6. A regular expression enclosed in queries *?’ addresses the line found by searching back¬ 
ward from the current line and stopping at the first line containing a string that 
matches the regular expression. If necessary the search wraps around to the end of the 
buffer. 

7. An address followed by a plus sign '+’ or a minus sign followed by a decimal 
number specifies that address plus (resp. minus) the indicated number of lines. The 
plus sign may be omitted. 

8. If an address begins with *+’ or the addition or subtraction is taken with respect to 
the current line; e.g. ‘-5’ is understood to mean ‘.-5’. 

9. If an address ends with or then 1 is added (resp. subtracted). As a consequence 
of this rule and rule 8, the address refers to the line before the current line. More¬ 
over, trailing ‘-f’ and characters have cumulative effect, so ‘—’ refers to the current 
line less 2. 

10. To maintain compatibility with earlier versions of the editor, the character in 
addresses is equivalent to 

Commands may require zero, one, or two addresses. Commands which require no addresses 
regard the presence of an address as an error. Commands which accept one or two addresses 
assume default addresses when insufficient are given. If more addresses are given than such a 
command requires, the last one or two (depending on what is accepted) are used. 

Addresses are separated from each other typically by a comma They may also be 
separated by a semicolon *j\ In this case the current line V is set to the previous address 
before the next address is interpreted. This feature can be used to determine the starting line 
for forward and backward searches (*/*, *?’). The second address of any two-address sequence 
must correspond to a line following the line corresponding to the first address. The special 
form is an abbreviation for the address pair T,$’. 

In the following list of ed commands, the default addresses are shown in parentheses. The 
parentheses are not part of the address, but are used to show that the given addresses are the 
default. 
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As mentioned, it is generally illegal for more than one command to appear on a line. How¬ 
ever, most commands may be suffixed by ‘p’ or by T, in which case the current line is either 
printed or listed respectively in the way discussed below. Commands may also be suffixed by 
‘n’, meaning the output of the command is to be line numbered. These suffixes may be com¬ 
bined in any order. 

(•) a 
<text> 

The append command reads the given text and appends it after the addressed line. V is 
left on the last line input, if there were any, otherwise at the addressed line. Address ‘0’ 
is legal for this command; text is placed at the beginning of the buffer. 

(., .) c 
<text> 

The change command deletes the addressed lines, then accepts input text which replaces 
these lines. is left at the last line input; if there were none, it is left at the line 
preceding the deleted lines. 

(.,.)d 

The delete command deletes the addressed lines from the buffer. The line originally 
after the last line deleted becomes the current line; if the lines deleted were originally at 
the end, the new last line becomes the current line. 

e filename 

The edit command causes the entire contents of the buffer to be deleted, and then the 
named file to be read in. V is set to the last line of the buffer. The number of charac¬ 
ters read is typed, ‘filename’ is remembered for possible use as a default file name in a 
subsequent r or w command. If ‘filename’ is missing, the remembered name is used. 

E filename 

This command is the same as e, except that no diagnostic results when no w has been 
given since the last buffer alteration. 

f filename 

The filename command prints the currently remembered file name. If ‘filename’ is given, 
the currently remembered file name is changed to ‘filename’. 

(1,$) g/regular expression/command list 

In the global command, the first step is to mark every line which matches the given reg¬ 
ular expression. Then for every such line, the given command list is executed with ‘.’ 
initially set to that line. A single command or the first of multiple commands appears 
on the same line with the global command. All lines of a multi-line list except the last 
line must be ended with l \. A, i, and c commands and associated input are permitted; 
the V terminating input mode may be omitted if it would be on the last line of the com¬ 
mand list. The commands g and v are not permitted in the command list. 

(-)i 

<text> 

This command inserts the given text before the addressed line. V is left at the last line 
input, or, if there were none, at the line before the addressed line. This command differs 
from the a command only in the placement of the text. 

(• > •+!) j 

This command joins the addressed lines into a single line; intermediate newlines simply 
disappear. V is left at the resulting line. 
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(•)k* 

The mark command marks the addressed line with name x , which must be a lower-case 
letter. The address form £/ x! then addresses this line. 

(.,.)! 

The list command prints the addressed lines in an unambiguous way: non-graphic char¬ 
acters are printed in two-digit octal, and long lines are folded. The / command may be 
placed on the same line after any non-i/o command. 

(., .) ma 

The move command repositions the addressed lines after the line addressed by a. The 
last of the moved lines becomes the current line. 

(• i •) n 

The number command prints the addressed lines with line numbers and a tab at the 
left. 

(•.Op 

The print command prints the addressed lines. V is left at the last line printed. The p 
command may be placed on the same line after any non-i/o command. 

(-.OP 

This command is a synonym for p. 

q The quit command causes ed to exit. No automatic write of a file is done. 

Q This command is the same as q, except that no diagnostic results when no w has been 
given since the last buffer alteration. 

($) r filename 

The read command reads in the given file after the addressed line. If no file name is 
given, the remembered file name, if any, is used (see e and /commands). The file name 
is remembered if there was no remembered file name already. Address ‘0 ? is legal for r 
and causes the file to be read at the beginning of the buffer. If the read is successful, the 
number of characters read is typed. V is left at the last line read in from the file. 

( .,.) s/regular expression/replacement/ or, 

( ., .) s/regular expression/replacement/g 

The substitute command searches each addressed line for an occurrence of the specified 
regular expression. On each line in which a match is found, all matched strings are 
replaced by the replacement specified, if the global replacement indicator ‘g’ appears 
after the command. If the global indicator does not appear, only the first occurrence of 
the matched string is replaced. It is an error for the substitution to fail on all addressed 
lines. Any punctuation character may be used instead of £ / 5 to delimit the regular 
expression and the replacement. V is left at the last line substituted. 

An ampersand l &’ appearing in the replacement is replaced by the string matching the 
regular expression. The special meaning of in this context may be suppressed by 
preceding it by c \\ The characters ‘\n’ where n is a digit, are replaced by the text 
matched by the n-th regular subexpression enclosed between ‘\(’ and *\)\ When nested, 
parenthesized subexpressions are present, n is determined by counting occurrences of ‘\(’ 
starting from the left. 

Lines may be split by substituting new-line characters into them. The new-line in the 
replacement string must be escaped by preceding it by c \\ 

One or two trailing delimiters may be omitted, implying the £ p’ suffix. The special form 
£ s’ followed by no delimiters repeats the most recent substitute command on the 
addressed lines. The V may be followed by the letters r (use the most recent regular 
expression for the left hand side, instead of the most recent left hand side of a substitute 
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command), p (complement the setting of the p suffix from the previous substitution), or 
g (complement the setting of the g suffix). These letters may be combined in any order. 

(., .)ta 

This command acts just like the m command, except that a copy of the addressed lines 
is placed after address a (which may be 0). V is left on the last line of the copy. 

(•>•)« 

The undo command restores the buffer to it’s state before the most recent buffer modify¬ 
ing command. The current line is also restored. Buffer modifying commands are a, c, d, 
g, i, k, and t;. For purposes of undo, g and v are considered to be a single buffer modify¬ 
ing command. Undo is its own inverse. 

When ed runs out of memory (at about 8000 lines on any 16 bit mini-computer such as 
the PDP-11) This full undo is not possible, and « can only undo the effect of the most 
recent substitute on the current line. This restricted undo also applies to editor scripts 
when ed is invoked with the - option. 

(1, $)v/regular expression/command list 

This command is the same as the global command g except that the command list is 
executed g with initially set to every line except those matching the regular expression. 

(1, $) w filename 

The write command writes the addressed lines onto the given file. If the file does not 
exist, it is created. The file name is remembered if there was no remembered file name 
already. If no file name is given, the remembered file name, if any, is used (see e and / 
commands). V is unchanged. If the command is successful, the number of characters 
written is printed. 

(1, $)W filename 

This command is the same as w, except that the addressed lines are appended to the file. 
(1, $) wq filename 

This command is the same as w except that afterwards a q command is done, exiting the 
editor after the file is written. 

x A key string is demanded from the standard input. Later r, e and w commands will 
encrypt and decrypt the text with this key by the algorithm of crypt( l). An explicitly 
empty key turns off encryption. (. +1) zor, 

(.+l)zn 

This command scrolls through the buffer starting at the addressed line. 22 (or n. if 
given) lines are printed. The last line printed becomes the current line. The value n is 
sticky, in that it becomes the default for future z commands. 

(*) = 

The line number of the addressed line is typed. V is unchanged by this command. 
!<shell command > 

The remainder of the line after the T is sent to s/i(l) to be interpreted as a command. 
V is unchanged. 

(.+1, .+1) < newline > 

An address alone on a line causes the addressed line to be printed. A blank line alone is 
equivalent to ‘.-kip’; it is useful for stepping through text. If two addresses are present 
with no intervening semicolon, ed prints the range of lines. If they are separated by a 
semicolon, the second line is printed. 

If an interrupt signal (ASCII DEL) is sent, ed prints ‘?interrupted’ and returns to its com¬ 
mand level. 
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Some size limitations: 512 characters per line, 256 characters per global command list, 64 char¬ 
acters per file name, and, on mini computers, 128K characters in the temporary file. The limit 
on the number of lines depends on the amount of core: each line takes 2 words. 

When reading a file, ed discards ASCII NUL characters and all characters after the last new- 
line. It refuses to read files containing non-ASCII characters. 


FILES 

/tmp/e* 

edhup: work is saved here if terminal hangs up 

SEE ALSO 

B. W. Kernighan, A Tutorial Introduction to the ED Text Editor 
B. W. Kernighan, Advanced editing on UNIX 
ex(l), sed(l), crypt(l) 

DIAGNOSTICS 

‘?name’ for inaccessible file; ^self-explanatory message’ for other errors. 

To protect against throwing away valuable work, a q or e command is considered to be in 
error, unless a tv has occurred since the last buffer change. A second q or e will be obeyed 
regardless. 


BUGS 

The / command mishandles DEL. 

The undo command causes marks to be lost on affected lines. 

The x command, -x option, and special treatment of hangups only work on UNIX. 
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NAME 

efl - Extended Fortran Language 

SYNOPSIS 

efl [ option ... ] [ filename ... ] 

DESCRIPTION 

Efl compiles a program written in the EFL language into clean Fortran. Efl provides the 
same control flow constructs as does ratfor( 1), which are essentially identical to those in C: 

statement grouping with braces; 

decision-making with if, if-else, and switch-case; while, for, Fortran do, repeat, and 
repeat...until loops; multi-level break and next. In addition, EFL has C-like data 
structures, and more uniform and convenient input/output syntax, generic functions. 
EFL also provides some syntactic sugar to make programs easier to read and write: 

free form input: 

multiple statements/line; automatic continuation statement label names (not just 
numbers), 

comments: 

# this is a comment 

translation of relation als: 

>, >=, etc., become .GT., .GE., etc. 

return (expression) 

returns expression to caller from function 
define: define name replacement 
include: 

include filename 

The Efl command option -w suppresses warning messages. The option —C causes comments 
to be copied through to the Fortran output (default); -# prevents comments from being 
copied through. If a command argument contains an embedded equal sign, that argument is 
treated as if it had appeared in an option statement at the beginning of the program. Efl is 
best used with /77( 1). 

SEE ALSO 

177(1), ratfor(l). 

S. I. Feldman, The Programming Language EFL, Bell Labs Computing Science Technical 
Report #78. 
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NAME 

eqn, neqn, checkeq - typeset mathematics 


SYNOPSIS 

eqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ file ] ... 
checkeq [ file ] ... 


DESCRIPTION 

Eqn is a troff(l) preprocessor for typesetting mathematics on a Graphic Systems photo¬ 
typesetter, neqn on terminals. Usage is almost always 

eqn file ... | troff 
neqn file ... | nroff 

If no files are specified, these programs reads from the standard input. A line beginning with 
‘.EQ’ marks the start of an equation; the end of an equation is marked by a line beginning 
with ‘.EN’. Neither of these lines is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to set two characters as ‘delimiters’; subsequent 
text between delimiters is also treated as eqn input. Delimiters may be set to characters x and 
y with the command-line argument -dxy or (more commonly) with ‘delim xy’ between .EQ 
and .EN. The left and right delimiters may be identical. Delimiters are turned off by ‘delim 
off’. All text that is neither between delimiters nor between .EQ and .EN is passed through 
untouched. 


The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, newlines, braces, double quotes, tildes or 
circumflexes. Braces {} are used for grouping; generally speaking, anywhere a single character 
like x could appear, a complicated construction enclosed in braces may be used instead. Tilde 
represents a full space in the output, circumflex ' half as much. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes 
x { , a sub i sup 2 produces a,- 2 , and e sup {x sup 2 + y sup 2} gives e* 2+y ~. 

Fractions are made with over: a over b yields y. 


sqrt makes square roots: 1 over sqrt {ox sup 2 +bx+ c} results in — . . 

v ax 2 +bx + c 

n 

The keywords from and to introduce lower and upper limits on arbitrary things: lim )T)z, is 

n—oo 0 

made with lim from {n-> inf } sum from 0 to n x sub i. 

Left and right brackets, braces, etc., of the right height are made with left and right: left [ x 


sup 2 + y sup 2 over alpha right ] ~ =~ 1 produces 


x“+- 


= 1. The right clause is optional. 


Legal characters after left and right are braces, brackets, bars, c and f for ceiling and floor, 
and "" for nothing at all (useful for a right-side-only bracket). 


Vertical piles of things are made with pile, lpile, cpile, and rpile: pile {a above b above c} 
a 

produces b. There can be an arbitrary number of elements in a pile, lpile left-justifies, pile 
c 

and cpile center, with different vertical spacing, and rpile right justifies. 
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Matrices are made with matrix: matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2}} pro- 
x { 1 

duces g- In addition, there is rcol for a right-justified column. 

Diacritical mark s are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot 
— f(t) bar is x—f ( t ), y dotdot bar ~ =~ n under is y = a, and x vec ~ y dyad is T = jf • 

Sizes and font can be changed with size n or size ±n, roman, italic, bold, and font n. Size 
and fonts can be changed globally in a document by gsize n and gfont n, or by the 
command-line arguments -sn and -fn. 

Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this 
may be changed by the command-line argument -pn. 

Successive display arguments can be lined up. Place mark before the desired lineup point in 
the first equation; place lineup at the place that is to line up vertically in subsequent equa¬ 
tions. 

Shorthands may be defined or existing keywords redefined with define: define thing % 
replacement % defines a new token called thing which will be replaced by replacement when¬ 
ever it appears thereafter. The % may be any character that does not occur in replacement. 

Keywords like sum (£)) int (f) inf (oo) and shorthands like >= (>) -> (—*•), and != (^) are 
recognized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. 
Mathematical words like sin, cos, log are made Roman automatically. Troff( 1) four-character 
escapes like \(bs (0) can be used anywhere. Strings enclosed in double quotes "..." are passed 
through untouched; this permits keywords to be entered as text, and can be used to communi¬ 
cate with troff when all else fails. 

SEE ALSO 

troff(l), tbl(l), ms(7), eqnchar(7) 

B. W. Kernighan and L. L. Cherry, Typesetting Mathematics — User’s Guide 
J. F. Ossanna, NROFF/TROFF User’s Manual 

BUGS 

To embolden digits, parens, etc., it is necessary to quote them, as in ‘bold ”12.3”’. 
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) NAME 

error - analyze and disperse compiler error messages 

SYNOPSIS 

error [ — n ] [ —s ] [ —q ] [ —v ] [ —t suffix list ] [ —I ignorefile ] [ name ] 

DESCRIPTION 

Error analyzes and optionally disperses the diagnostic error messages produced by a number 
of compilers and language processors to the source file and line where the errors occurred. It 
can replace the painful, traditional methods of scribbling abbreviations of errors on paper, and 
permits error messages and source code to be viewed simultaneously without machinations of 
multiple windows in a screen editor. 

Error looks at the error messages, either from the specified file name or from the standard 
input, and attempts to determine which language processor produced each error message, 
determines the source file and line number to which the error message refers, determines if the 
error message is to be ignored or not, and inserts the (possibly slightly modified) error message 
into the source file as a comment on the line preceding to which the line the error message 
refers. Error messages which can’t be categorized by language processor or content are not 
inserted into any file, but are sent to the standard output. Error touches source files only 
after all input has been read. By specifying the -q query option, the user is asked to confirm 
any potentially dangerous (such as touching a file) or verbose action. Otherwise error 
proceeds on its merry business. If the —t touch option and associated suffix list is given, error 
will restrict itself to touch only those files with suffices in the suffix list. Error also can be 
asked (by specifying —v) to invoke w‘(l) on the files in which error messages were inserted; 
this obviates the need to remember the names of the files with errors. 

Error is intended to be run with its standard input connected via a pipe to the error message 
source. Some language processors put error messages on their standard error file; others put 
their messages on the standard output. Hence, both error sources should be piped together 
into error. For example, when using the csh syntax, 

make -s lint |& error -q -v 

will analyze all the error messages produced by whatever programs make runs when making 
lint. 

Error knows about the error messages produced by: make, cc, cpp, ccom, as, Id, lint, pi, pc 
and f77. Error knows a standard format for error messages produced by the language proces¬ 
sors, so is sensitive to changes in these formats. For all languages except Pascal, error mes¬ 
sages are restricted to be on one line. Some error messages refer to more than one line in 
more than one files; error will duplicate the error message and insert it at all of the places 
referenced. 

Error will do one of six things with error messages. 
synchronize 

Some language processors produce short errors describing which file it is process¬ 
ing. Error uses these to determine the file name for languages that don’t include 
the file name in each error message. These synchronization messages are consumed 
entirely by error. 

discard Error messages from lint that refer to one of the two lint libraries, /usr/lib/llib-lc 
and /usr/lib/llib-port are discarded, to prevent accidently touching these libraries. 
Again, these error messages are consumed entirely by error. 
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nullify Error messages from lint can be nullified if they refer to a specific function, which 
is known to generate diagnostics which are not interesting. Nullified error mes¬ 
sages are not inserted into the source file, but are written to the standard output. 
The names of functions to ignore are taken from either the file named .errorrc in 
the users’s home directory, or from the file named by the -I option. If the file 
does not exist, no error messages are nullified. If the file does exist, there must be 
one function name per line. 

not file specific 

Error messages that can’t be intuited are grouped together, and written to the 
standard output before any files are touched. They will not be inserted into any 
source file. 

file specific 

Error message that refer to a specific file, but to no specific line, are written to the 
standard output when that file is touched. 

true errors Error messages that can be intuited are candidates for insertion into the file to 
which they refer. 

Only true error messages are candidates for inserting into the file they refer to. Other error 
messages are consumed entirely by error or are written to the standard output. Error inserts 
the error messages into the source file on the line preceding the line the language processor 
found in error. Each error message is turned into a one line comment for the language, and is 
internally flagged with the string “ #//# ” at the beginning of the error, and “%%%” at the 
end of the error. This makes pattern searching for errors easier with an editor, and allows the 
messages to be easily removed. In addition, each error message contains the source line 
number for the line the message refers to. A reasonably formatted source program can be 
recompiled with the error messages still in it, without having the error messages themselves 
cause future errors. For poorly formatted source programs in free format languages, such as 
C or Pascal, it is possible to insert a comment into another comment, which can wreak havoc 
with a future compilation. To avoid this, programs with comments and source on the same 
line should be formatted so that language statements appear before comments. 

Options available with error are: 

—n Do not touch any files; all error messages are sent to the standard output. 

-q The user is queried whether s/he wants to touch the file. A “y” or “n” to the question 
is necessary to continue. Absence of the —q option implies that all referenced files 
(except those referring to discarded error messages) are to be touched. 

—v After all files have been touched, overlay the visual editor vi with it set up to edit all 

files touched, and positioned in the first touched file at the first error. If t n can’t be 

found, try ex or ed from standard places. 

-t Take the following argument as a suffix list. Files whose suffixes do not appear in the 

suffix list are not touched. The suffix list is dot separated, and wildcards work. 

Thus the suffix list: 

".c.y.foo*.h" 

allows error to touch files ending with “.c”, “.y”, “.foo*” and “.y”. 

—a Print out statistics regarding the error categorization. Not too useful. 

Error catches interrupt and terminate signals, and if in the insertion phase, will orderly ter¬ 
minate what it is doing. 
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AUTHOR 

Robert Henry 


FILES 

"/.errorrc function names to ignore for lint error messages 

/dev/tty user’s teletype 


BUGS 

Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor’s format of error messages may cause error to not understand 
the error message. 

Error, since it is purely mechanical, will not filter out subsequent errors caused by ‘floodgat¬ 
ing’ initiated by one syntactically trivial error. Humans are still much better at discarding 
these related errors. 

Pascal error messages belong after the lines affected (error puts them before). The alignment 
of the ‘ |’ marking the point of error is also disturbed by error. 

Error was designed for work on CRT’s at reasonably high speed. It is less pleasant on slow 
speed terminals, and has never been used on hardcopy terminals. 


ICON INTERNATIONAL 


3 



EX( 1) 


USER COMMANDS 


EX( 1) 


NAME 

ex, edit - text editor 

SYNOPSIS 

ex [ ~ 1 [ ~ v ] [ ~t tag ] [ —r ] [ + command ] [ — 1 ] name ... 
edit [ ex options ] 

DESCRIPTION 

Ex is the root of a family of editors: edit, ex and vi. Ex is a superset of ed, with the most not¬ 
able extension being a display editing facility. Display based editing is the focus of vi. 

If you have not used ed, or are a casual user, you will find that the editor edit is convenient 
for you. It avoids some of the complexities of ex used mostly by systems programmers and 
persons very familiar with ed. 

If you have a CRT terminal, you may wish to use a display based editor; in this case see vi( 1), 
which is a command which focuses on the display editing portion of ex. 

DOCUMENTATION 

The document Edit: A tutorial provides a comprehensive introduction to edit assuming no pre¬ 
vious knowledge of computers or the UNIX system. 

The Ex Reference Manual - Version 5.5 is a comprehensive and complete manual for the com¬ 
mand mode features of ex, but you cannot learn to use the editor by reading it. For an intro¬ 
duction to more advanced forms of editing using the command mode of ex see the editing 
documents written by Brian Ivernighan for the editor ed; the material in the introductory and 
advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the display editor vi and provides refer¬ 
ence material on vi. All of these documents can be found in volume 2c of the Programmer’s 
Manual. In addition, the Vi Quick Reference card summarizes the commands of vi in a useful, 
functional way, and is useful with the Introduction. 


FILES 

/usr/lib/ex?.?strings 
/usr/lib/ex?.?recover 
/usr/lib / ex?.?preserve 
/etc/term cap 
~/.exrc 

/tmp/Exnnnnn 
/ tmp /R xnnnnn 
/usr/preserve 


error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor temporary 
named buffer temporary 
preservation directory 


SEE ALSO 

awk(l), ed(l), grep(l), sed(l), grep(l), vi(l), termcap(5), environ(7) 


AUTHOR 

Originally written by William Joy 

Mark Horton has maintained the editor since version 2.7, adding macros, support for many 
unusual terminals, and other features such as word abbreviation mode. 
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BUGS 

The undo command causes all marks to be lost on lines changed and then restored if the 
marked lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. More than a screen full 
of output may result if long lines are present. 

File input/output errors don’t print a name if the command line ’ option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exiting the 
editor. 

Null characters are discarded in input files, and cannot appear in resultant files. 
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NAME 

expand, unexpand - expand tabs to spaces, and vice versa 
SYNOPSIS 

expand [ -tabstop ] [ -tabl,tab2,...,tabn ] [ file ... ] 
unexpand [ — a ] [ file ... ] 

DESCRIPTION 

Expand processes the named files or the standard input writing the standard output with tabs 
changed into blanks. Backspace characters are preserved into the output and decrement the 
column count for tab calculations. Expand is useful for pre-processing character files (before 
sorting, looking at specific columns, etc.) that contain tabs. 

If a single tabstop argument is given then tabs are set tabstop spaces apart instead of the 
default 8. If multiple tabstops are given then the tabs are set at those specific columns. 

Unexpand puts tabs back into the data from the standard input or the named files and writes 
the result on the standard output. By default only leading blanks and tabs are reconverted to 
maximal strings of tabs. If the —a option is given, then tabs are inserted whenever they 
would compress the resultant file by replacing two or more characters. 
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NAME 

explain, diction- print wordy sentences; thesaurus for diction 

SYNOPSIS 

diction [ —ml ] [ —mm ] [ -n ] [ -f pfile ] file ... 

explain 

DESCRIPTION 

Diction finds all sentences in a document that contain phrases from a data base of bad or 
wordy diction. Each phrase is bracketed with [ ]. Because diction runs deroff before looking 
at the text, formatting header files should be included as part of the input. The default 
macro package —ms may be overridden with the flag —mm. The flag —ml which causes deroff 
to skip lists, should be used if the document contains many lists of non-sentences. The user 
may supply her/his own pattern file to be used in addition to the default file with -f pfile. If 
the flag —n is also supplied the default file will be suppressed. 

Explain is an interactive thesaurus for the phrases found by diction. 

SEE ALSO 

deroff(l) 


BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, 
diction doesn’t grok —me. 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arg ... 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is written on the stan¬ 
dard output. Each token of the expression is a separate argument. 

The operators and keywords are listed below. The list is in order of increasing precedence, 
with equal precedence operators grouped. 

expr | expr 

yields the first expr if it is neither null nor ‘O’, otherwise yields the second expr. 
expr & expr 

yields the first expr if neither expr is null or ‘O’, otherwise yields ‘O’. 
expr relop expr 

where relop is one of < <— = != >= >, yields ‘1’ if the indicated comparison is 
true, ‘0’ if false. The comparison is numeric if both expr are integers, otherwise lexico¬ 
graphic. 

expr + expr 
expr - expr 

addition or subtraction of the arguments. 

expr * expr 
expr / expr 
expr % expr 

multiplication, division, or remainder of the arguments. 
expr : expr 

The matching operator compares the string first argument with the regular expression 
second argument; regular expression syntax is the same as that of ed{ 1). The \(...\) 
pattern symbols can be used to select a portion of the first argument. Otherwise, the 
matching operator yields the number of characters matched (‘0’ on failure). 

( expr ) 

parentheses for grouping. 

Examples: 

To add 1 to the Shell variable a: 
a='expr $a + 1' 

To find the filename part (least significant part) of the pathname stored in variable a, which 
may or may not contain */’: 

expr $a : '.*/\( -*\)' '|' $a 
Note the quoted Shell metacharacters. 

SEE ALSO 

sh(l), test(l) 
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DIAGNOSTICS 

Expr returns the following exit codes: 

0 if the expression is neither null nor ‘O’, 

1 if the expression is null or ‘O’, 

2 for invalid expressions. 
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NAME 

eyacc - modified yacc allowing much improved error recovery 

SYNOPSIS 

eyacc [ -v ] [ grammar ] 

DESCRIPTION 

Eyacc is an old version of yacc( 1), which produces tables used by the Pascal system and its 
error recovery routines. Eyacc fully enumerates test actions in its parser when an error token 
is in the look-ahead set. This prevents the parser from making undesirable reductions when 
an error occurs before the error is detected. The table format is different in eyacc than it was 
in the old yacc, as minor changes had been made for efficiency reasons. 

SEE ALSO 

yacc(l) 

“Practical LR Error Recovery” by Susan L. Graham, Charles B. Haley and W. N. Joy; SIG- 
PLAN Conference on Compiler Construction, August 1979. 

AUTHOR 

S. C. Johnson 

Eyacc modifications by Charles Haley and William Joy. 


BUGS 

Pc and its error recovery routines should be made into a library of routines for the new yacc. 
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NAME 

f77 - Fortran 77 compiler 

SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several types of arguments: 

Arguments whose names end with ‘.f are taken to be Fortran 77 source programs; they are 
compiled, and each object program is left on the file in the current directory whose name is 
that of the source with ‘.o’ substituted for ’.f. 

Arguments whose names end with ‘.F’ are also taken to be Fortran 77 source programs; these 
are first processed by the C preprocessor before being compiled by /77. 

Arguments whose names end with ‘.r’ or ‘.e’ are taken to be Ratfor or EFL source programs 
respectively; these are first transformed by the appropriate preprocessor, then compiled by 
f77. 

Arguments whose names end with ‘.c’ or ‘.s’ are taken to be C or assembly source programs 
and are compiled or assembled, producing a ‘.o’ file. 

The following options have the same meaning as in cc(l). See ld{ 1) for load-time options. 

—c Suppress loading and produce ‘.o’ files for each source file. 

—g Have the compiler produce additional symbol table information for d6i(l). Also pass 

the -lg flag to ld{ 1). 

—o output 

Name the final output file output instead of ‘a.out’. 

—p Prepare object files for profiling, see prof( 1). 

—pg Causes the compiler to produce counting code in the manner of -p, but invokes a 

run-time recording mechanism that keeps more extensive statistics and produces a 
gmon.out file at normal termination. An execution profile can then be generated by use 
of gprof( 1). 

—f Compiles floating point operations to use the MC68881 floating point coprocessor. 

Also switches to versions of libc.a, libm.a, libF77.a, and libI77.a that use the floating 
point chip. Setting the environment variable FP to m68881 has the same effect as 
specifying this flag. Code generated with this option will cause an ’Illegal instruction" 
trap on machines without the floating point coprocessor. 

—w Suppress all warning messages. If the option is ‘-w66’, only Fortran 66 compatibility 

warnings are suppressed. 

— D name—dej 

-D name 

Define the name to the C preprocessor, as if by ‘^define’. If no definition is given, the 
name is defined as "1". (‘.F’ suffix files only). 

—Idir ‘^include’ files whose names do not begin with ‘/’ are always sought first in the direc¬ 
tory of the file argument, then in directories named in —I options, then in directories 
on a standard list. (‘.F’ suffix files only). 

— O Invoke an object-code optimizer. 

—S Compile the named programs, and leave the assembler-language output on correspond¬ 

ing files suffixed ‘.s’. (No ‘.o’ is created.). 
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The following options are peculiar to f77. 

—12 On machines which support short integers, make the default integer constants and 
variables short. (—14 is the standard value of this option). All logical quantities will be 
short. 

—m Apply the M4 preprocessor to each ‘.r’ file before transforming it with the Ratfor or 

EFL preprocessor. 

—onetrip 

Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops 
are not performed at all if the upper limit is smaller than the lower limit.) 

—u Make the default type of a variable ‘undefined’ rather than using the default Fortran 

rules. 

—v Print the version number of the compiler, and the name of each pass as it executes. 

—C Compile code to check that subscripts are within declared array bounds. 

—F Apply the C, EFL, or Ratfor preprocessors to relevant files, put the result in the file 

with the suffix changed to ‘.f, but do not compile. 

-Ez Use the string a: as an EFL option in processing ‘.e’ files. 

—Rz Use the string x as a Ratfor option in processing ‘.r’ files. 

—N[qxscn]nnn 

Make static tables in the compiler bigger. The compiler will complain if it overflow's its 
tables and suggest you apply one or more of these flags. These flags have the following 
meanings: 

q Maximum number of equivalenced variables. Default is 150. 

x Maximum number of external names (common block names, subroutine and 
function names). Default is 200. 

s Maximum number of statement numbers. Default is 401. 

c Maximum depth of nesting for control statements (e.g. DO loops). Default is 

20 . 

n Maximum number of identifiers. Default is 1009. 

—U Do not convert upper case letters to low’er case. The default is to convert Fortran pro¬ 

grams to lower case except w'ithin character string constants. 

Other arguments are taken to be either loader option arguments, or F77-compatible object 
programs, typically produced by an earlier run, or perhaps libraries of F77-compatible rou¬ 
tines. These programs, together with the results of any compilations specified, are loaded (in 
the order given) to produce an executable program with name ‘a.out’. 


FILES 

file. [fF resc] 

file.o 

a.out 

/usr/lib/f 77passl 
/lib/fl 
/lib/c2 
/lib/cpp 

/usr/lib/libF77.a 

/usr/lib/libI77.a 

/usr/lib/libU77.a 


input file 
object file 
loaded output 
compiler 
pass 2 

optional optimizer 
C preprocessor 
intrinsic function library 
Fortran I/O library 
UNIX interface library 
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/usr/lib/libF77_p.a 

/usr/lib/libI77_p.a 

/usr/lib/libU77_p.a 

/lib/libc.a 

mon.out 

gmon.out 


profiling intrinsic function library 
profiling Fortran I/O library 
profiling UNIX interface library 
C library, see section 3 
file produced for analysis by prof(l). 
file produced for analysis by gprof(l). 


SEE ALSO 

S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler 
D. L. Wasley, Introduction to the f77 I/O Library 
prof(l), gprof(l), cc(l), ld(l), efl(l), ratfor(l) 


DIAGNOSTICS 

The diagnostics produced by /77 itself are intended to be self-explanatory. Occasional mes¬ 
sages may be produced by the loader. 


BUGS 

This compiler is still somewhat experimental. The optimizer occasionally makes mistakes: it 
should be avoided when debugging if apparently incorrect results are obtained. Because of an 
assembler error, complaints about long branches may occur with very large source files; such 
errors can be avoided by splitting the sources into smaller sections. If necessary, the old ver¬ 
sion of /77 can be resurrected from /usr/src/old. 
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NAME 

false, true - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True and false are usually used in a Bourne shell script. They test for the appropriate status 
"true" or "false” before running (or failing to run) a list of commands. 

EXAMPLE 

while false 
do 

command list 
done 

SEE ALSO 

csh(l), sh(l), true(l) 

DIAGNOSTICS 

False has exit status nonzero. 
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NAME 

file - determine file type 

SYNOPSIS 

file file ... 

DESCRIPTION 

File performs a series of tests on each argument in an attempt to classify it. If an argument 
appears to be ascii, file examines the first 512 bytes and tries to guess its language. 

BUGS 

It often makes mistakes. In particular it often suggests that command files are C programs. 
Does not recognize Pascal or LISP. 
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NAME 

find - find files 

SYNOPSIS 

find pathname-list expression 

DESCRIPTION 

Find recursively descends the directory hierarchy for each pathname in the pathname-list (i.e., 
one or more pathnames) seeking files that match a boolean expression written in the primaries 
given below. In the descriptions, the argument n is used as a decimal integer where +n means 
more than n, -n means less than n and n means exactly n. 

—name filename 

True if the filename argument matches the current file name. Normal Shell argu¬ 
ment syntax may be used if escaped (watch out for *?’ and V). 

—perm onum 

True if the file permission flags exactly match the octal number onum (see 
chmod(l)). If onum is prefixed by a minus sign, more flag bits (017777, see stat( 2)) 
become significant and the flags are compared: (flags&onum)==onum. 

—type c True if the type of the file is c, where c is b, c, d, f or 1 for block special file, char¬ 
acter special file, directory, plain file, or symbolic link. 

-links n True if the file has n links. 

—user uname 

True if the file belongs to the user uname (login name or numeric user ID). 

—group gname 

True if the file belongs to group gname (group name or numeric group ID). 

—size n True if the file is n blocks long (512 bytes per block). 

—inum n True if the file has inode number n. 

—atime n True if the file has been accessed in n days. 

—mtime n True if the file has been modified in n days. 

—exec command 

True if the executed command returns a zero value as exit status. The end of the 
command must be punctuated by an escaped semicolon. A command argument 
“{}’ is replaced by the current pathname. 

—ok command 

Like -exec except that the generated command is written on the standard output, 
then the standard input is read and the command executed only upon response y. 

-print Always true; causes the current pathname to be printed. 

—newer file 

True if the current file has been modified more recently than the argument file. 

The primaries may be combined using the following operators (in order of decreasing pre¬ 
cedence): 

1) A parenthesized group of primaries and operators (parentheses are special to the Shell 
and must be escaped). 

2) The negation of a primary ('!’ is the unary not operator). 
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3) Concatenation of primaries (the and operation is implied by the juxtaposition of two pri¬ 
maries). 

4) Alternation of primaries (‘—o’ is the or operator). 

EXAMPLE 

To remove all files named ‘a.out’ or ‘*.o’ that have not been accessed for a week: 
find / \( -name a.out -o -name ’*.o’ \) -atime +7 -exec rm {} \; 

FILES 

/etc/passwd 

/etc/group 

SEE ALSO 

sh(l), test(l), fs(5) 


BUGS 

The syntax is painful. 
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NAME 

finger - user information lookup program 

SYNOPSIS 

finger [ options ] name ... 

DESCRIPTION 

By default finger lists the login name, full name, terminal name and write status (as a V 
before the terminal name if write permission is denied), idle time, login time, and office loca¬ 
tion and phone number (if they are known) for each current UNIX user. (Idle time is minutes 
if it is a single integer, hours and minutes if a V is present, or days and hours if a ’d’ is 
present.) 

A longer format also exists and is used by finger whenever a list of peoples names is given. 
(Account names as well as first and last names of users are accepted.) This format is multi- 
line, and includes all the information described above as well as the user’s home directory and 
login shell, any plan which the person has placed in the file .plan in their home directory, and 
the project on which they are working from the file .project also in the home directory. 

Finger options include: 

-m Match arguments only on user name. 

—1 Force long output format. 

-p Suppress printing of the .plan files 
—s Force short output format. 

FILES 

/etc/utmp 
/etc/passwd 
/ usr/adm/lastlog 
'/.plan 
'/.project 

SEE ALSO 

w(l), who(l) 

AUTHOR 

Earl T. Cohen 


who file 

for users names, offices, ... 

last login times 

plans 

projects 


BUGS 

Only the first line of the .project file is printed. 

The encoding of the geos field is UCB dependent - it knows that an office ‘197MC’ is ‘197M 
Cory Hall’, and that ‘529BE’ is ‘529B Evans Hall’. 

A user information data base is in the works and will radically alter the way the information 
that finger uses is stored. Finger will require extensive modification when this is implemented. 
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NAME 

fold - fold long lines for finite width output device 

SYNOPSIS 

fold [ -width ] [ file ... ] 

DESCRIPTION 

Fold is a filter which will fold the contents of the specified files, or the standard input if no 
files are specified, breaking the lines to have maximum width width. The default for width is 
80. Width should be a multiple of 8 if tabs are present, or the tabs should be expanded using 
expand( 1) before coming to fold. 

SEE ALSO 

expand(l) 


BUGS 

If underlining is present it may be messed up by folding. 
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NAME 

fp - Functional Programming language compiler/interpreter 
SYNOPSIS 

DESCRIPTION 

Fp is an interpreter/compiler that implements the applicative language proposed by John 
Backus. It is written in FRANZ LISP. 

In a functional programming language intent is expressed in a mathematical style devoid of 
assignment statements and variables. Functions compute by value only; there are no side- 
effects since the result of a computation depends solely on the inputs. 

Fp "programs" consist of functional expressions - primitive and user-defined fp functions com¬ 
bined by functional forms. These forms take functional arguments and return functional 
results. For example, the composition operator takes two functional arguments and 
returns a function which represents their composition. 

There exists a single operation in fp - application. This operation causes the system to evalu¬ 
ate the indicated function using the single argument as input (all functions are monadic). 

GETTING STARTED 

Fp invokes the system. Fp compiles functions into lisp( 1) source code; lisp( 1) interprets this 
code (the user may compile this code using the liszt (1) compiler to gain a factor of 10 in per¬ 
formance). Control D exits back to the shell. Break terminates any computation in progress 
and resets any open file units. )help provides a short summary of all user commands. 


FILES 

/usr/ucb/lisp the FRANZ LISP interpreter 
/usr/ucb/liszt the liszt compiler 
/usr/doc/fp the User’s Guide 

SEE ALSO 

lisp(l), liszt(l). 

The Berkeley FP user’s manual, available on-line. The language is described in the August 
1978 issue of CACM (Turing award lecture by John Backus). 


BUGS 

If a non-terminating function is applied as the result of loading a file, then control is returned 
to the user immediately, everything after that position in the file is ignored. 

FP incorrectly marks the location of a syntax error on large, multi-line function definitions or 
applications. 


AUTHOR 

Scott B. Baden 
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NAME 

fpr - print Fortran file 

SYNOPSIS 

fpr 

DESCRIPTION 

Fpr is a filter that transforms files formatted according to Fortran’s carriage control conven¬ 
tions into files formatted according to UNIX line printer conventions. 

Fpr copies its input onto its output, replacing the carriage control characters with characters 
that will produce the intended effects when printed using /pr(l). The first character of each 
line determines the vertical spacing as follows: 


Character 

Vertical Space Before Printing 

Blank 

0 

1 

_±_ 

One line 

Two lines 

To first line of next page 

No advance 


A blank line is treated as if its first character is a blank. A blank that appears as a carriage 
control character is deleted. A zero is changed to a newline. A one is changed to a form feed. 
The effects of a "+" are simulated using backspaces. 

EXAMPLES 

a.out | fpr | lpr 

fpr < f77.output | lpr 


AUTHOR 

Robert P. Corbett 


BUGS 

Results are undefined for input lines longer than 170 characters. 
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NAME 

fpu - determine presence of the floating point coprocessor 

SYNOPSIS 

fpu [ -s ] 

DESCRIPTION 

Fpu prints whether or not the MC68881 floating point coprocessor (unit) is installed. The -s 
(silent) flag suppresses printing (except for error messages). It is used for checking error status 
(in shell scripts for example). 

EXAMPLE 

The the following is a shell script that demonstrates the use of the -s flag: 

#! /bin/csh -f 
fpu -s 

if (Sstatus) then 

echo No FPU installed. 

else 

echo FPU installed. 

end if 
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NAME 

from - who is my mail from? 

SYNOPSIS 

from [ -s sender ] [ user ] 

DESCRIPTION 

From prints out the mail header lines in your mailbox file to show you who your mail is from. 
If user is specified, then user’s mailbox is examined instead of your own. If the -s option is 
given, then only headers for mail sent by sender are printed. 


FILES 

/ usr / spool/mail/* 

SEE ALSO 

biff(l), mail(l), prmail(l) 
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NAME 

fsplit - split a multi-routine Fortran file into individual files 

SYNOPSIS 

fsplit [ -e efile] ... [ file ] 

DESCRIPTION 

Fsplit takes as input either a file or standard input containing Fortran source code. It 
attempts to split the input into separate routine files of the form name./ where name is the 
name of the program unit (e.g. function, subroutine, block data or program). The name for 
unnamed block data subprograms has the form blkdtaNNN.f where NNN is three digits and a 
file of this name does not already exist. For unnamed main programs the name has the form 
mainNNN.f. If there is an error in classifying a program unit, or if name./ already exists, the 
program unit will be put in a file of the form zzzNNN.f where zzzNNN.f does not already 
exist. 

Normally each subprogram unit is split into a separate file. When the -e option is used, only 
the specified subprogram units are split into separate files. E.g.: 

fsplit -e readit -e doit prog.f 
will split readit and doit into separate files. 

DIAGNOSTICS 

If names specified via the -e option are not found, a diagnostic is written to standard error. 

AUTHOR 

Asa Romberger and Jerry Berkman 


BUGS 

Fsplit assumes the subprogram name is on the first noncomment line of the subprogram unit. 
Nonstandard source formats may confuse fsplit. 

It is hard to use -e for unnamed main programs and block data subprograms since you must 
predict the created file name. 
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NAME 

ftp - file transfer program 

SYNOPSIS 

ftp [ -v ] [ -d ] [ -i ] [ -n ] [ -g ] [ host ] 

DESCRIPTION 

Ftp is the user interface to the ARPANET standard File Transfer Protocol. The program 
allows a user to transfer files to and from a remote network site. 

The client host with which ftp is to communicate may be specified on the command line. If 
this is done, ftp will immediately attempt to establish a connection to an FTP server on that 
host; otherwise, ftp will enter its command interpreter and await instructions from the user. 
When ftp is awaiting commands from the user the prompt “ftp>” is provided the user. The 
following commands are recognized by ftp: 

! Invoke a shell on the local machine, 

append local-file [ remote-file ] 

Append a local file to a file on the remote machine. If remote-file is left unspecified, 
the local file name is used in naming the remote file. File transfer uses the current set¬ 
tings for type, format, mode, and structure. 

ascii Set the file transfer type to network ASCII. This is the default type. 

bell Arrange that a bell be sounded after each file transfer command is completed. 

binary 

Set the file transfer type to support binary image transfer, 
bye Terminate the FTP session with the remote server and exit ftp. 
cd remote-directory 

Change the working directory on the remote machine to remote-directory. 

close Terminate the FTP session with the remote server, and return to the command inter¬ 
preter. 

delete remote-file 

Delete the file remote-file on the remote machine, 
debug [ debug-value ] 

Toggle debugging mode. If an optional debug-value is specified it is used to set the 
debugging level. When debugging is on, ftp prints each command sent to the remote 
machine, preceded by the string 

dir [ remote-directory ] [ local-file ] 

Print a listing of the directory contents in the directory, remote-directory , and, option¬ 
ally, placing the output in local-file. If no directory is specified, the current working 
directory on the remote machine is used. If no local file is specified, output comes to 
the terminal. 

form format 

Set the file transfer form to format. The default format is “file”, 
get remote-file [ local-file ] 

Retrieve the remote-file and store it on the local machine. If the local file name is not 
specified, it is given the same name it has on the remote machine. The current set¬ 
tings for type, form, mode, and structure are used while transferring the file. 
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hash Toggle hash-sign (“#”) printing for each data block transferred. The size of a data 
block is 1024 bytes. 

glob Toggle file name globbing. With file name globbing enabled, each local file or path¬ 
name is processed for csh(l) metacharacters. These characters include “*?[]'{}”. 
Remote files specified in mutliple item commands, e.g. mput, are globbed by the 
remote server. With globbing disabled all files and pathnames are treated literally. 

help [ command ] 

Print an informative message about the meaning of command. If no argument is 
given, ftp prints a list of the known commands. 

led [ directory ] 

Change the working directory on the local machine. If no directory is specified, the 
user’s home directory is used. 

Is [ remote-directory ] [ local-file ] 

Print an abbreviated listing of the contents of a directory on the remote machine. If 
remote-directory is left unspecified, the current working directory is used. If no local 
file is specified, the output is sent to the terminal. 

mdelete remote-files 

Delete the specified files on the remote machine. If globbing is enabled, the 
specification of remote files will first be expanded using Is. 

mdir remote-files local-file 

Obtain a directory listing of multiple files on the remote machine and place the result 
in local-file. 

mget remote-files 

Retrieve the specified files from the remote machine and place them in the current 
local directory. If globbing is enabled, the specification of remote files will first be 
expanding using Is. 

mkdir directory-name 

Make a directory on the remote machine. 

mis remote-files local-file 

Obtain an abbreviated listing of multiple files on the remote machine and place the 
result in local-file. 

mode [ mode-name ] 

Set the file transfer mode to mode-name. The default mode is “stream” mode, 
mput local-files 

Transfer multiple local files from the current local directory to the current working 
directory on the remote machine. 

open host [ port ] 

Establish a connection to the specified host FTP server. An optional port number may 
be supplied, in which case, ftp will attempt to contact an FTP server at that port. If 
the auto-login option is on (default), ftp will also attempt to automatically log the user 
in to the FTP server (see below). 

prompt 

Toggle interactive prompting. Interactive prompting occurs during multiple file 
transfers to allow the user to selectively retrieve or store files. If prompting is turned 
off (default), any mget or mput will transfer all files. 
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put local-file [ remote-file ] 

Store a local file on the remote machine. If remote-file is left unspecified, the local file 
name is used in naming the remote file. File transfer uses the current settings for type, 
format, mode, and structure. 

pwd Print the name of the current working directory on the remote machine, 
quit A synonym for bye. 
quote argl argS... 

The arguments specified are sent, verbatim, to the remote FTP server. A single FTP 
reply code is expected in return. 

recv remote-file [ local-file ] 

A synonym for get. 

remotehelp [ command-name ] 

Request help from the remote FTP server. If a command-name is specified it is sup¬ 
plied to the server as well. 

rename [ from ] [ to ] 

Rename the file from on the remote machine, to the file to. 

rmdir directory-name 

Delete a directory on the remote machine. 

send local-file [ remote-file ] 

A synonym for put. 

sendport 

Toggle the use of PORT commands. By default, ftp will attempt to use a PORT com¬ 
mand when establishing a connection for each data transfer. If the PORT command 
fails, ftp will use the default data port. When the use of PORT commands is disabled, 
no attempt will be made to use PORT commands for each data transfer. This is use¬ 
ful for certain FTP implementations which do ignore PORT commands but, 
incorrectly, indicate they’ve been accepted. 

status Show the current status of ftp. 
struct [ struct-name } 

Set the file transfer structure to struct-name. By default “stream” structure is used, 
tenex Set the file transfer type to that needed to talk to TENEX machines, 
trace Toggle packet tracing, 
type [ type-name ] 

Set the file transfer type to type-name. If no type is specified, the current type is 
printed. The default type is network ASCII. 

user user-name [ password ] [ account ] 

Identify yourself to the remote FTP server. If the password is not specified and the 
server requires it, ftp will prompt the user for it (after disabling local echo). If an 
account field is not specified, and the FTP server requires it, the user will be prompted 
for it. Unless ftp is invoked with “auto-login” disabled, this process is done automati¬ 
cally on initial connection to the FTP server. 

verbose 

Toggle verbose mode. In verbose mode, all responses from the FTP server are 
displayed to the user. In addition, if verbose is on, when a file transfer completes, 
statistics regarding the efficiency of the transfer are reported. By default, verbose is 
on. 
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f [ command ] 

A synonym for help. 

Command arguments which have embedded spaces may be quoted with quote (") marks. 

FILE NAMING CONVENTIONS 

Files specified as arguments to ftp commands are processed according to the following rules. 

1) If the file name is specified, the stdin (for reading) or stdout (for writing) is used. 

2) If the first character of the file name is the remainder of the argument is inter¬ 
preted as a shell command. Ftp then forks a shell, using popen(3) with the argument 
supplied, and reads (writes) from the stdout (stdin). If the shell command includes 
spaces, the argument must be quoted; e.g. “”| Is -It"”. A particularly useful example of 
this mechanism is: “dir frnore”. 

3) Failing the above checks, if “globbing” is enabled, local file names are expanded 
according to the rules used in the csh(l); c.f. the glob command. 

FILE TRANSFER PARAMETERS 

The FTP specification specifies many parameters which may affect a file transfer. The type 
may be one of “ascii”, “image” (binary), “ebcdic”, and “local byte size” (for PDP-lO’s and 
PDP-20’s mostly). Ftp supports the ascii and image types of file transfer. 

Ftp supports only the default values for the remaining file transfer parameters: mode, form, 
and struct. 

OPTIONS 

Options may be specified at the command line, or to the command interpreter. 

The —v (verbose on) option forces ftp to show all responses from the remote server, as well as 
report on data transfer statistics. 

The -n option restrains ftp from attempting “auto-login” upon initial connection. If auto¬ 
login is enabled, ftp will check the .netrc file in the user’s home directory for an entry describ¬ 
ing an account on the remote machine. If no entry exists, ftp will use the login name on the 
local machine as the user identity on the remote machine, and prompt for a password and, 
optionally, an account with which to login. 

The -i option turns off interactive prompting during mutliple file transfers. 

The -d option enables debugging. 

The -g option disables file name globbing. 


BUGS 

Many FTP server implementation do not support the experimental operations such as print 
working directory. Aborting a file transfer does not work right; if one attempts this the local 
ftp will likely have to be killed by hand. 


4 


ICON INTERNATIONAL 



GCORE(1) 


USER COMMANDS 


GCORE(1) 


NAME 

gcore - get core images of running processes 

SYNOPSIS 

gcore process-id ... 

DESCRIPTION 

Gcore creates a core image of each specified process, suitable for use with adb(l) or dbx(l). 

FILES 

core.<process-id> core images 

BUGS 

Paging activity that occurs while gcore is running may cause the program to become confused. 
For best results, the desired processes should be stopped. 
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NAME 

gprof - display call graph profile data 

SYNOPSIS 

gprof [ options ] ( a.out [ gmon.out... ] ] 

DESCRIPTION 

gprof produces an execution profile of C, Pascal, or Fortran77 programs. The effect of called 
routines is incorporated in the profile of each caller. The profile data is taken from the call 
graph profile file ( gmon.out default) which is created by programs which are compiled with the 
—pg option of cc, pc, and /77. That option also links in versions of the library routines which 
are compiled for profiling. The symbol table in the named object file (a.out default) is read 
and correlated with the call graph profile file. If more than one profile file is specified, the 
gprof output shows the sum of the profile information in the given profile files. 

First, a flat profile is given, similar to that provided by pro/(l). This listing gives the total 
execution times and call counts for each of the functions in the program, sorted by decreasing 
time. 

Next, these times are propagated along the edges of the call graph. Cycles are discovered, and 
calls into a cycle are made to share the time of the cycle. A second listing shows the functions 
sorted according to the time they represent including the time of their call graph descendents. 
Below each function entry is shown its (direct) call graph children, and how their times are 
propagated to this function. A similar display above the function shows how this function’s 
time and the time of its descendents is propagated to its (direct) call graph parents. 

Cycles are also shown, with an entry for the cycle as a whole and a listing of the members of 
the cycle and their contributions to the time and call counts of the cycle. 

The following options are available: 

-a suppresses the printing of statically declared functions. If this option is given, all 
relevant information about the static function ( e.g., time samples, calk to other func¬ 
tions, calls from other functions) belongs to the function loaded just before the static 
function in the a.out file. 

—b supresses the printing of a description of each field in the profile. 

—c the static call graph of the program is discovered by a heuristic which examines the 

text space of the object file. Static-only parents or children are indicated with call 
counts of 0. 

—e name 

suppresses the printing of the graph profile entry for routine name and all its descen¬ 
dants (unless they have other ancestors that aren’t suppressed). More than one -e 
option may be given. Only one name may be given with each -e option. 

— E name 

suppresses the printing of the graph profile entry for routine name (and its descen¬ 
dants) as —e, above, and also excludes the time spent in name (and its descendants) 
from the total and percentage time computations. (For example, -E mcount -E 
mcleanup is the default.) 

-f name 

prints the graph profile entry of only the specified routine name and its descendants. 
More than one -f option may be given. Only one name may be given with each -f 
option. 
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—F name 

prints the graph profile entry of only the routine name and its descendants (as —f, 
above) and also uses only the times of the printed routines in total time and percen¬ 
tage computations. More than one -F option may be given. Only one name may be 
given with each — F option. The -F option overrides the -E option. 

—s a profile file gmon.sum is produced which represents the sum of the profile information 

in all the specified profile files. This summary profile file may be given to subsequent 
executions of gprof (probably also with a -s) to accumulate profile data across several 
runs of an a.out file. 

—x displays routines which have zero usage (as indicated by call counts and accumulated 
time). This is useful in conjunction with the —c option for discovering which routines 
were never called. 

FILES 

a.out the namelist and text space. 

gmon.out dynamic call graph and profile. 

gmon.sum summarized dynamic call graph and profile. 

SEE ALSO 

monitor(3), profil(2), cc(l), prof(l) 

“gprof: A Call Graph Execution Profiler”, by Graham, S.L., Kessler, P.B., McKusick, M.K.; 

Proceedings of the SIGPLAN ’82 Symposium on Compiler Construction, SIGPLAN Notices, 

Vol. 17, No. 6, pp. 120-126, June 1982. 


BUGS 

Beware of quantization errors. The granularity of the sampling is shown, but remains statist¬ 
ical at best. We assume that the time for each execution of a function can be expressed by 
the total time for the function divided by the number of times the function is called. Thus 
the time propagated along the call graph arcs to parents of that function is directly propor¬ 
tional to the number of times that arc is traversed. 

Parents which are not themselves profiled will have the time of their profiled children pro¬ 
pagated to them, but they will appear to be spontaneously invoked in the call graph listing, 
and will not have their time propagated further. Similarly, signal catchers, even though 
profiled, will appear to be spontaneous (although for more obscure reasons). Any profiled 
children of signal catchers should have their times propagated properly, unless the signal 
catcher was invoked during the execution of the profiling routine, in which case all is lost. 

The profiled program must call exit{ 2) or return normally for the profiling information to be 
saved in the gmon.out file. 
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NAME 

graph - draw a graph 

SYNOPSIS 

graph [ option ] ... 

DESCRIPTION 

Graph with no options takes pairs of numbers from the standard input as abscissas and ordi¬ 
nates of a graph. Successive points are connected by straight lines. The graph is encoded on 
the standard output for display by the plot( 1G) filters. 

If the coordinates of a point are followed by a nonnumeric string, that string is printed as a 
label beginning on the point. Labels may be surrounded with quotes in which case they 
may be empty or contain blanks and numbers; labels never contain newlines. 

The following options are recognized, each as a separate argument. 

-a Supply abscissas automatically (they are missing from the input); spacing is given by 
the next argument (default 1). A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by —x). 

—b Break (disconnect) the graph after each label in the input. 

—c Character string given by next argument is default label for each point. 

—g Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid (default). 

—1 Next argument is label for graph. 

—m Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected 

(default). Some devices give distinguishable line styles for other small integers. 

—s Save screen, don’t erase before plotting. 

-* [ 1 ] 

If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x 
limits. Third argument, if present, is grid spacing on x axis. Normally these quanti¬ 
ties are determined automatically. 

-y [ 1 1 

Similarly for y. 

—h Next argument is fraction of space for height. 

-w Similarly for width. 

—r Next argument is fraction of space to move right before plotting. 

—u Similarly to move up before plotting. 

— t Transpose horizontal and vertical axes. (Option -x now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the -s option is present. 

If a specified lower limit exceeds the upper limit, the axis is reversed. 

SEE ALSO 

spline(lG), plot(lG) 


BUGS 

Graph stores all points internally and drops those for which there isn’t room. 
Segments that run out of bounds are dropped, not windowed. 

Logarithmic axes may not be reversed. 
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NAME 

grep, egrep, fgrep - search a file for a pattern 

SYNOPSIS 

grep [ option ] ... expression [ file ] ... 
egrep [ option ] ... [ expression ] [ file ] ... 
fgrep [ option ] ... [ strings ] [ file ] 

DESCRIPTION 

Commands of the grep family search the input files (standard input default) for lines match¬ 
ing a pattern. Normally, each line found is copied to the standard output. Grep patterns are 
limited regular expressions in the style of ex(l); it uses a compact nondeterministic algorithm. 
Egrep patterns are full regular expressions; it uses a fast deterministic algorithm that some¬ 
times needs exponential space. Fgrep patterns are fixed strings; it is fast and compact. The 
following options are recognized. 

—v All lines but those matching are printed. 

—x (Exact) only lines matched in their entirety are printed (fgrep only). 

—c Only a count of matching lines is printed. 

—1 The names of files with matching lines are listed (once) separated by newlines. 

-n Each line is preceded by its relative line number in the file. 

—b Each line is preceded by the block number on which it was found. This is sometimes 

useful in locating disk block numbers by context. 

-i The case of letters is ignored in making comparisons — that is, upper and lower case 
are considered identical. This applies to grep and fgrep only. 

—s Silent mode. Nothing is printed (except error messages). This is useful for checking 

the error status. 

—w The expression is searched for as a word (as if surrounded by ‘\<’ and see 

ex(l).) ( grep only) 

—e expression 

Same as a simple expression argument, but useful when the expression begins with a -. 

—f file The regular expression (egrep) or string list (fgrep) is taken from the file. 

In all cases the file name is shown if there is more than one input file. Care should be taken 
when using the characters $ * [ | ( ) and \ in the expression as they are also meaningful to 

the Shell. It is safest to enclose the entire expression argument in single quotes ' '. 

Fgrep searches for lines that contain one of the (newdine-separated) strings. 

Egrep accepts extended regular expressions. In the folkwing description ‘character’ excludes 
newline: 

A \ followed by a single character other than newline matches that character. 

The character ' matches the beginning of a line. 

The character $ matches the end of a line. 

A . (period) matches any character. 

A single character not otherwise endowed with special meaning matches that charac¬ 
ter. 
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A string enclosed in brackets [ ] matches any single character from the string. Ranges 
of ASCII character codes may be abbreviated as in ‘a-zO-9’. A ] may occur only as 
the first character of the string. A literal - must be placed where it can’t be mistaken 
as a range indicator. 

A regular expression followed by an * (asterisk) matches a sequence of 0 or more 
matches of the regular expression. A regular expression followed by a + (plus) 
matches a sequence of 1 or more matches of the regular expression. A regular expres¬ 
sion followed by a ? (question mark) matches a sequence of 0 or 1 matches of the regu¬ 
lar expression. 

Two regular expressions concatenated match a match of the first followed by a match 
of the second. 

Two regular expressions separated by | or newline match either a match for the first or 
a match for the second. 

A regular expression enclosed in parentheses matches a match for the regular expres¬ 
sion. 

The order of precedence of operators at the same parenthesis level is [ ] then *+? then concate¬ 
nation then | and newline. 

Ideally there should be only one grep, but we don’t know a single algorithm that spans a wide 
enough range of space-time tradeoffs. 

SEE ALSO 

ex(l), sed(l), sh(l) 

DIAGNOSTICS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or inaccessible files. 

BUGS 

Lines are limited to 256 characters; longer lines are truncated. 
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NAME 

groups - show group memberships 

SYNOPSIS 

groups [user] 

DESCRIPTION 

The groups command shows the groups to which you or the optionally specified user belong. 
Each user belongs to a group specified in the password file /etc/passwd and possibly to other 
groups as specified in the file /etc/group. If you do not own a file but belong to the group 
which it is owned by then you are granted group access to the file. 

When a new file is created it is given the group of the containing directory. 

SEE ALSO 

setgroups(2) 


FILES 

/etc/passwd, /etc/group 

BUGS 

More groups should be allowed. 
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NAME 

head - give first few lines 

SYNOPSIS 

head [ -count ] [ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the specified files, or of the standard input. If 
count is omitted it defaults to 10. 



SEE ALSO 

tail(l) 


* 
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NAME 

hostid - set or print identifier of current host system 


SYNOPSIS 

hostid [ identifier ] 

DESCRIPTION 

The hostid command prints the identifier of the current host in hexadecimal. This numeric 
value is expected to be unique across all hosts and is normally set to the host’s Internet 
address. The super-user can set the hostid by giving a hexadecimal argument; this is usually 
done in the startup script /etc/rc.local. 


SEE ALSO 

gethostid(2), sethostid(2) 
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NAME 

hostname - set or print name of current host system 

SYNOPSIS 

hostname [ nameofhost ] 

DESCRIPTION 

The hostname command prints the name of the current host, as given before the “login” 
prompt. The super-user can set the hostname by giving an argument; this is usually done in 
the startup script /etc/rc.local. 

SEE ALSO 

gethostname(2), sethostname(2) 
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NAME 

ident — identify files 

SYNOPSIS 

ident file ... 

DESCRIPTION 

Ident searches the named files for all occurrences of the pattern %keyword:...%, where keyword 
is one of 

Author 

Date 

Header 

Locker 

Log 

Revision 

Source 

State 

These patterns are normally inserted automatically by the RCS command co (.1), but can 
also be inserted manually. 

Ident works on text files as well as object files. For example, if the C program in file f.c con¬ 
tains 


char rcsid[] = "SHeader: Header information $"; 
and f.c is compiled into f.o, then the command 
ident f.c f.o 
will print 
f.c: 

SHeader: Header information $ 
f.o: 

SHeader: Header information $ 


IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 
Revision Number: 3.0 ; Release Date: 82/12/04 . 

Copyright ° 1982 by Walter F. Tichy. 


SEE ALSO 

ci (1), co (1), res (1), rcsdiff(l), rcsintro (1), resmerge (1), rlog (1), resfile (5). 

Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 
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NAME 

indent - indent and format C program source 

SYNOPSIS 

indent input [ output ] [ flags ] 


DESCRIPTION 

Indent is intended primarily as a C program formatter. Specifically, indent will: 

• indent code lines 

• align comments 

• insert spaces around operators where necessary 

• break up declaration lists as in “int a,b,c;”. 

Indent will not break up long statements to make them fit within the maximum line length, 
but it will flag lines that are too long. Lines will be broken so that each statement starts a 
new line, and braces will appear alone on a line. (See the -br option to inhibit this.) Also, an 
attempt is made to line up identifiers in declarations. 

The flags which can be specified follow. They may appear before or after the file names. If the 
output file is omitted, the formatted file will be written back into input and a “backup” copy 
of input will be written in the current directory. If input is named “/blah/blah/file”, the 
backup file will be named “.Bfile”. If output is specified, indent checks to make sure it is 
different from input. 

The following flags may be used to control the formatting style imposed by indent. 


—1 nnn 
—cnnn 
—cd nnn 


—mnn 


Maximum length of an output line. The default is 75. 

The column in which comments will start. The default is 33. 

The column in which comments on declarations will start. The default is for these 
comments to start in the same column as other comments. 


The number of spaces for one indentation level. The default is 4. 

—dj,—ndj —dj will cause declarations to be left justified. — ndj will cause them to be indented 
the same as code. The default is -ndj. 

-v,-nv —v turns on “verbose” mode, -nv turns it off. When in verbose mode, indent 
will report when it splits one line of input into two or more lines of output, and it 
will give some size statistics at completion. The default is -nv. 

—be,—nbc If -be is specified, then a newline will be forced after each comma in a declaration, 
“nbc will turn off this option. The default is “be. 

“dnnn This option controls the placement of comments which are not to the right of 
code. Specifying ~d2 means that such comments will be placed two indentation 
levels to the left of code. The default ~d0 lines up these comments with the code. 
See the section on comment indentation below. 


“br,-bl Specifying —bl will cause complex statements to be lined up like this: 

if (...) 

{ 

code 

} 
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Specifying -br (the default) will make them look like this: 

if (-) ( O 

code V ^ 

} 

You may set up your own “profile” of defaults to indent by creating the file “.indent.pro” in 
your login directory and including whatever switches you like. If indent is run and a profile 
file exists, then it is read to set up the program’s defaults. Switches on the command line, 
though, will always override profile switches. The profile file must be a single line of not more 
than 127 characters. The switches should be separated on the line by spaces or tabs. 

Multi-line expressions 

Indent will not break up complicated expressions that extend over multiple lines, but it will 
usually correctly indent such expressions which have already been broken up. Such an expres¬ 
sion might end up looking like this: 
x = 

( 

(Arbitrary parenthesized expression) 

+ 

( 

(Parenthesized expression) 

* 

(Parenthesized expression) 

) 

); 

Comments 

Indent recognizes four kinds of comments. They are: straight text, “box” comments, UNIX- 
style comments, and comments that should be passed through unchanged. The action taken V 

with these various types are as follows: 

“Box” comments. Indent assumes that any comment with a dash immediately after the start 
of comment (i.e. “/*-”) is a comment surrounded by a box of stars. Each line of such a com¬ 
ment will be left unchanged, except that the first non-blank character of each successive line 
will be lined up with the beginning slash of the first line. Box comments will be indented (see 
below). 

“ Unix-style” comments. This is the type of section header which is used extensively in the 
UNIX system source. If the start of comment (“/*”) appears on a line by itself, indent 
assumes that it is a UNIX-style comment. These will be treated similarly to box comments, 
except the first non-blank character on each line will be lined up with the V of the 

Unchanged comments . Any comment which starts in column 1 will be left completely 
unchanged. This is intended primarily for documentation header pages. The check for 
unchanged comments is made before the check for UNIX-style comments. 

Straight text. All other comments are treated as straight text. Indent will fit as many words 
(separated by blanks, tabs, or newlines) on a line as possible. Straight text comments will be 
indented. 

Comment indentation 

Box, UNIX-style, and straight text comments may be indented. If a comment is on a line 
with code it will be started in the “comment column”, which is set by the -cnnn command 
line parameter. Otherwise, the comment will be started at nnn indentation levels less than 
where code is currently being placed, where nnn is specified by the — dnnn command line 

V. y 
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parameter. (Indented comments will never be placed in column 1.) If the code on a line 
extends past the comment column, the comment will be moved to the next line. 

DIAGNOSTICS 

Diagnostic error messages, mostly to tell that a text line has been broken or is too long for the 
output line. 


FILES 

.indent.pro profile file 

BUGS 

Does not know how to format “long” declarations. 
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NAME 

install - install binaries 

SYNOPSIS 

install [ — c ] [ -m mode ] [ —o owner ] [ —g group ] [ —s ] binary destination 



DESCRIPTION 

Binary is moved (or copied if —c is specified) to destination. If destination already exists, it is 
removed before binary is moved. If the destination is a directory then binary is moved into 
the destination directory with its original file-name. 

The mode for Destination is set to 755; the —m mode option may be used to specify a different 
mode. 

Destination is changed to owner root; the —o owner option may be used to specify a different 
owner. 

Destination is changed to group staff; the —g group option may be used to specify a different 
group. 

If the —s option is specified the binary is stripped after being installed. 

Install refuses to move a file onto itself. 


SEE ALSO 

chgrp(l), chmod(l), cp(l), mv(l), strip(l), chown(8) 
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NAME 

iostat - report I/O statistics 

SYNOPSIS 

iostat [ interval [ count ] ] 

DESCRIPTION 

Iostat iteratively reports the number of characters read and written to terminals, and, for each 
disk, the number of seeks transfers per second, kilobytes transfered per second, and the mil¬ 
liseconds per average seek. It also gives the percentage of time the system has spent in user 
mode, in user mode running low priority (niced) processes, in system mode, and idling. 

To compute this information, for each disk, seeks and data transfer completions and number 
of words transferred are counted; for terminals collectively, the number of input and output 
characters are counted. Also, each sixtieth of a second, the state of each disk is examined and 
a tally is made if the disk is active. From these numbers and given the transfer rates of the 
devices it is possible to determine average seek times for each device. 

The optional interval argument causes iostat to report once each interval seconds. The first 
report is for all time since a reboot and each subsequent report is for the last interval only. 

The optional count argument restricts the number of reports. 

FILES 

/dev/kmem 

/vmunix 

SEE ALSO 

vmstat(l) 
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NAME 

ipcrm - remove a message queue, semaphore set or shared memory id 


SYNOPSIS 

ipcrm [ options ] 


DESCRIPTION 

Ipcrm will remove one or more specified messages, semaphore or shared memory identifiers. 

The identifiers are specified by the following options: 

—q msqid removes the message queue identifier msqid from the system and destroys the 

message queue and data structure associated with it. 

—m shmid removes the shared memory identifier shmid from the system. The shared 

memory segment and data structure associated with it are destroyed after the 
last detach. 


—s semid 
—Q msgkey 


—M shmkey 


—S semkey 


removes the semaphore identifier semid from the system and destroys the set of 
semaphores and data structure associated with it. 

removes the message queue identifier, created with key msgkey, from the system 
and destroys the message queue and data structure associated with it. 

removes the shared memory identifier, created with key shmkey, from the sys¬ 
tem. The shared memory segment and data structure associated with it are des¬ 
troyed after the last detach. 

removes the semaphore identifier, created with key semkey, from the system and 
destroys the set of semaphores and data structure associated with it. 


The details of the removes are described in msgctl{ 2), shmctl( 2), and semctl( 2). The identifiers 
and keys may be found by using ipcs{ 1). 


SEE ALSO 

ipcs(l). 

msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), shmget(2), shmop(2) 
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NAME 

ipcs - report inter-process communication facilities status 

SYNOPSIS 

ipcs [ options ] 

DESCRIPTION 

Ipcs prints certain information about active inter-process communication facilities. Without 
options , information is printed in short format for message queues, shared memory, and sema¬ 
phores that are currently active in the system. Otherwise, the information that is displayed is 
controlled by the following options : 

-q Print information about active message queues. 

—m Print information about active shared memory segments. 

—s Print information about active semaphores. 

If any of the options —q, —m, or —s are specified, information about only those indicated will 
be printed. If none of these three are specified, information about all three will be printed. 

— b Print biggest allowable size information. (Maximum number of bytes in messages on 

queue for message queues, size of segments for shared memory, and number of sema¬ 
phores in each set for semaphores.) See below for meaning of columns in a listing. 

—c Print creator’s login name and group name. See below. 

—o Print information on outstanding usage. (Number of messages on queue and total 

number of bytes in messages on queue for message queues and number of processes 
attached to shared memory segments.) 

-p Print process number information. (Process ID of last process to send a message and 
process ID of last process to receive a message on message queues and process ID of 
creating process and process ID of last process to attach or detach on shared memory 
segments) See below. 

—t Print time information. (Time of the last control operation that changed the access 

permissions for all facilities. Time of last msgsnd and last msgrcv on message queues, 
last shmat and last shmdt on shared memory, last semop( 2) on semaphores.) See 
below. 

-a Use all print options. (This is a shorthand notation for — b, — c, — o, — p, and — t.) 

—C corefile 

Use the file corefile in place of /dev/kmem. 

—N namelist 

The argument will be taken as the name of an alternate namelist (/unix is the 
default). 

The column headings and the meaning of the columns in an ipcs listing are given below; the 
letters in parentheses indicate the options that cause the corresponding heading to appear; all 
means that the heading always appears. Note that these options only determine what infor¬ 


mation is provided for each facility; they do not determine which facilities will be listed. 


T 

(all) 

Type of the facility: 



q message queue; 

m shared memory segment; 

s semaphore. 

ID 

(all) 

The identifier for the facility entry. 
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KEY (all) 


MODE (all) 


OWNER 

(all) 

GROUP 

(all) 

CREATOR 

(a,c) 

CGROUP 

(a,c) 

CBYTES 

(a,o) 

QNUM 

(a,o) 

QBYTES 

(a,b) 

LSPID 

(a,p) 

LRPID 

( a .P) 

STIME 

(a,t) 

RTIME 

(a,t) 

CTIME 

(a,t) 

NATTCH 

(a,o) 

SEGSZ 

(a,b) 

CPID 

(a,p) 

LPED 

(a,p) 

ATIME 

(a,t) 

DTIME 

(a,t) 

NSEMS 

(a,b) 


The key used as an argument to msgget, semget, or shmget to create the 
facility entry. (Note: The key of a shared memory segment is changed to 
IPCLPRIVATE when the segment has been removed until all processes 
attached to the segment detach it.) 

The facility access modes and flags: The mode consists of 11 characters that 
are interpreted as follows: 

The first two characters are: 

R if a process is waiting on a msgrcv; 

S if a process is waiting on a msgsnd ; 

D if the associated shared memory segment has been removed. It 
will disappear when the last process attached to the segment 
detaches it; 

C if the associated shared memory segment is to be cleared when 
the first attach is executed; 

- if the corresponding special flag is not set. 

The next 9 characters are interpreted as three sets of three bits each. The 
first set refers to the owner’s permissions; the next to permissions of others 
in the user-group of the facility entry; and the last to all others. Within 
each set, the first character indicates permission to read, the second charac¬ 
ter indicates permission to write or alter the facility entry, and the last 
character is currently unused. 

The permissions are indicated as follows: 
r if read permission is granted; 
w if write permission is granted; 
a if alter permission is granted; 

— if the indicated permission is not granted. 

The login name of the owner of the facility entry. 

The group name of the group of the owner of the facility entry. 

The login name of the creator of the facility entry. 

The group name of the group of the creator of the facility entry. 

The number of bytes in messages currently outstanding on the associated 
message queue. 

The number of messages currently outstanding on the associated message 
queue. 

The maximum number of bytes allowed in messages outstanding on the 
associated message queue. 

The process ID of the last process to send a message to the associated queue. 
The process ID of the last process to receive a message from the associated 
queue. 

The time the last message was sent to the associated queue. 

The time the last message was received from the associated queue. 

The time when the associated entry was created or changed. 

The number of processes attached to the associated shared memory seg¬ 
ment. 

The size of the associated shared memory segment. 

The process ID of the creator of the shared memory entry. 

The process ID of the last process to attach or detach the shared memory 
segment. 

The time the last attach was completed to the associated shared memory 
segment. 

The time the last detach was completed on the associated shared memory 
segment. 

The number of semaphores in the set associated with the semaphore entry. 


2 


ICON INTERNATIONAL 




IPCS (1) 


USER COMMANDS 


IPCS(l) 


OTIME (a,t) The time the last semaphore operation was completed on the set associated 
with the semaphore entry. 


FILES 

/vmunix 

/dev/kmem 

/etc/passwd 

/etc/group 


system namelist 
memory 
user names 
group names 


SEE ALSO 

msgop(2), semop(2), shmop(2) 


BUGS 

Things can change while ipcs is running; the picture it gives is only a close approximation to 
reality. 
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NAME 

join - relational database operator 

SYNOPSIS 

join [ options ] filel file2 

DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified by the lines of filel 
and fileS. If filel is the standard input is used. 

Filel and fileS must be sorted in increasing ASCII collating sequence on the fields on which 
they are to be joined, normally the first in each line. 

There is one line in the output for each pair of lines in filel and fileS that have identical join 
fields. The output line normally consists of the common field, then the rest of the line from 
filel, then the rest of the line from fileS. 

Fields are normally separated by blank, tab or newline. In this case, multiple separators 
count as one, and leading separators are discarded. 

These options are recognized: 

—an In addition to the normal output, produce a line for each unpairable line in file n, 
where n is 1 or 2. 

—e s Replace empty output fields by string s. 

—jn m Join on the mth field of file n. If n is missing, use the mth field in each file. 

—o list Each output line comprises the fields specified in list, each element of which has the 
form n.m, where n is a file number and m is a field number. 

-tc Use character c as a separator (tab character). Every appearance of c in a line is 
significant. 

SEE ALSO 

sort(l), comm(l), awk(l) 


BUGS 

With default field separation, the collating sequence is that of sort -6; with -t, the sequence is 
that of a plain sort. 

The conventions of join, sort, comm, uniq, look and awk(\) are wildly incongruous. 
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NAME 

jove - an interactive display-oriented text editor 

SYNOPSIS 

jove [-d directory] [-w] [-t tag] [+n file] [-p file] [files] 
jove -r 

DESCRIPTION 

JOVE is Jonathan’s Own Version of Emacs. It is based on the original EMACS editor 
written at MIT by Richard Stallman. Although JOVE is meant to be compatible with 
EMACS, there are some major differences between the two editors and you shouldn’t rely on 
their behaving identically. 

JOVE works on any reasonable display terminal that is described in the termcap file (see 
TERMCAP(5) for more details). When you start up JOVE, it checks to see whether you have 
your TERM environment variable set. On most systems that will automatically be set up for 
you, but if it’s not JOVE will ask you w r hat kind of terminal you are using. To avoid having 
to type this every time you run JOVE you can set your TERM environment variable yourself. 
How you do this depends on which shell you are running. If you are running the C Shell, as 
most of you are, you type 

% setenv TERM type 

and with the Bourne Shell, you type 

$ TERM= type ; export TERM 

where type is the name of the kind of terminal you are using (e.g., vtlOO). If neither of these 
works get somebody to help you. 

INVOKING JOVE 

If you run JOVE with no arguments you will be placed in an empty buffer, called Mam. 
Otherwise, any arguments you supply are considered file names and each is "given" its own 
buffer. Only the first file is actually read in-reading other files is deferred until you actually 
try to use the buffers they are attached to. This is for efficiency’s sake: most of the time, 
when you run JOVE on a big list of files, you end up editing only a few of them. 

The names of all of the files specified on the command line are saved in a buffer, called 
Minibuf. The mini-buffer is a special JOVE buffer that is used when JOVE is prompting for 
some input to many commands (for example, when JOVE is prompting for a file name). 
When you are being prompted for a file name, you can type C-N (that’s Control-N) and C-P 
to cycle through the list of files that were specified on the command line. The file name will 
be inserted where you are typing and then you can edit it as if you typed it in yourself. 

JOVE recognizes the following switches: 

-d The following argument is taken to be the name of the current directory. This is for 
systems that don’t have a version of C shell that automatically maintains the CWD 
environment variable. If -d is not specified on a system without a modified C shell, 
JOVE will have to figure out the current directory itself, and that can be VERY slow. 

+n Reads the file, designated by the following argument, and positions point at the n’th 
line instead of the (default) l’st line. This can be specified more than once but it 
doesn’t make sense to use it twice on the same file; in that case the second one wins. 
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-p Parses the error messages in the file designated by the following argument. The error 
messages are assumed to be in a format similar to the C compiler, LINT, or GREP 
output. 

-t Runs the find-tag command on the following argument (see ctags(l)). 

-w Divides the window in two. When this happens, either the same file is displayed in 
both windows, or the second file in the list is read in and displayed in its window. 

As a special case, invoking JOVE with the -r option runs JOVE_RECOVER. Use this when 
the system crashes, or JOVE crashes, or you accidently get logged out while in JOVE. If 
there are any buffers to be recovered, this will find them. Read the documentation for 
JOVE_RECOVER. 

GETTING HELP 

Once in JOVE, there are several commands available to get help. To execute any JOVE 
command, you type "<ESC> X command-name” followed by <Return>. To get a list of 
all the JOVE commands you type "<ESC> X" followed by "?”. The describe-bindings 
command can be used to get a list containing each key, and its associated command (that is, 
the command that gets executed when you type that key). If you want to save the list of 
bindings, you can set the jove variable send-typeout-to-buffer to ON (using the set command), 
and then execute the describe-bindings command. This will create a buffer and put in it the 
bindings list it normally would have printed on the screen. Then you can save that buffer to 
a file and print it to use as a quick reference card. (See VARIABLES below.) 

Once you know the name of a command, you can find out what it does with the describe- 
command command, which you can invoke quickly by typing "ESC ?". The apropos command 
will give you a list of all the command with a specific string in their names. For example, if 
you want to know the names of all the commands that are concerned with windows, you can 
run "apropos" with the keyword window. 

If you’re not familar with the EMACS command set, it would be worth your while to use run 
TEACHJOVE. Do do that, just type "teachjove" to your shell and you will be placed in 
JOVE in a file which contains directions. I highly recommend this for beginners; you may 
save yourself a lot of time and headaches. 

KEY BINDINGS and VARIABLES 

You can alter the key bindings in JOVE to fit your personal tastes. That is, you can change 
what a key does every time you strike it. For example, by default the C-N key is bound to 
the command next-line and so when you type it you move down a line. If you want to change 
a binding or add a new one, you use the bind-to-key command. The syntax is "bind-to-key 
<command> key". 

You can also change the way JOVE behaves in little ways by changing the value of some 
variables with the set command. The syntax is "set <variable> value", where value is a 
number or a string, or "on" or "off", depending on the context. For example, if you want 
JOVE to make backup files, you set the "make-backup-files" variable to "on". To see the 
value of a variable, use the "print <variable>" command. 

INITIALIZATION 

JOVE automatically reads commands from an initialization file in your HOME directory, 
called "joverc". In this file you can place commands that you would normally type in JOVE. 
If you like to rearrange the key bindings and set some variables every time you get into 
JOVE, you should put them in your initialization file. Here are a few lines from mine: 
set match-regular-expressions on 
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auto-execute-command auto-fill /tmp/Re\|.*drft 

bind-to-key i-search-forward A \ 

bind-to-key i-searcb-reverse A R 

bind-to-key find-tag-at-point A [ A T 

bind-to-key scroll-down A C 

bind-to-key grow-window A Xg 

bind-to-key shrink-window A Xs 

(Note that the Control Characters can be either two character sequences (e.g. ' and C 
together as A C) or the actual control character. If you want to use an A by itself you must 
BackSlash it (e.g., bind-to-key grow-window A X\ A binds grow-window to MA X A "). 

SOME MINOR DETAILS 

You should type C-\ instead of C-S in many instances. For example, the way to search for a 
string is documented as being "C-S" but in reality you should type "C-\". This is because C-S 
is the XOFF character (what gets sent when you type the NO SCROLL key), and clearly that 
won’t work. The XON character is ”C-Q" (what gets sent when you type NO SCROLL again) 
which is documented as the way to do a quoted-insert. The alternate key for this is "C-'" 
(typed as "C-‘" on vtlOO’s and its look-alikes). If you want to enable C-S and C-Q and you 
know what you are doing, you can put the line: 

set allow-' S-an d- A Q on 
in your initialization file. 

If your terminal has a metakey, JOVE will use it if you turn on the "meta-key” variable. 
JOVE will automatically turn on "meta-key" if the METAKEY environment variable exists. 
This is useful for if you have different terminals (e.g., one at home and one at work) and one 
has a metakey and the other doesn’t. 


FILES 

/usr/new/lib/jove/.joverc - system wide initialization file 
~/.joverc - personal initialization file 
/tmp - where temporary files are stored 
/usr/new/lib/jove/teach-jove - the interactive tutorial 
/usr/new/lib/jove/portsrv - for running shells in windows (pdpll only) 

SEE ALSO 

jove_recover(l) - to recover buffers after a 
system/editor crash 

ed(l) - for a description of regular expressions 
teachjove(l) - for an interactive JOVE tutorial. 

DIAGNOSTICS 

JOVE diagnostics are meant to be self-explanatory, but you are advised to seek help whenever 
you are confused. You can easily lose a lot of work if you don’t know EXACTLY what you 
are doing. 


BUGS 

Lines can’t be more than 1024 characters long. 
Searches can’t cross line boundaries. 
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NAME 

jove_recover - recover JOVE buffers after a system/editor crash 

SYNOPSIS 

jove_recover [-syscrash] [-d directory] jove -r 

DESCRIPTION 

JOVE_RECOVER lets you recover your work in the JOVE editor in the event of a system or 
JOVE crash. It is designed to put invoked through JOVE with the "-r" switch. 
JOVE_RECOVER looks for JOVE buffers that are left around and are owned by you. (You 
cannot recover other peoples’ buffers, obviously.) When the system is rebooted after a crash, 
you type "jove -r" after you’ve logged in. If there were no buffers that were modified at the 
time of the crash or there were but JOVE_RECOVER can’t get its hands on them, you will 
be informed with the message, There is nothing here for you. Otherwise, JOVE_RECOVER 
prints the date and time of the version of the buffers it has, and then waits for you type a 
command. 

To get a list of the buffers JOVE_RECOVER knows about, use the list command. This will 
list all the buffers and the files and the number of lines associated with them. Next to each 
buffer is a number. When you want to recover a buffer, use the get command. The syntax is 
get buffer filename where buffer is either the buffer’s name or the number at the beginning of 
the line. If you don’t type the buffer name or the filename, JOVE_RECOVER will prompt 
you for them. 

If there are a lot of buffers and you want to recover all of them, use the recover command. 
This will recover each buffer to the name of the buffer with prepended to the name (so 
that the original isn’t over-written). It asks for each file and if you want to restore that 
buffer to that name you type "yes". If you want to recover the file but to a different name, 
just type that name in. If you type "no" JOVE_RECOVER will skip that file and go on to 
the next one. 

If you want to look at a buffer before deciding to recover it, use the print command. The syn¬ 
tax for this is print buffer where buffer again is either its name or the number. You can type 
~C if you want to abort printing the file to the terminal, and JOVE_RECOVER will respond 
with an appropriate message. 

When you’re done and have all the buffers you want, type the quit command to leave. You 
will then be asked whether it’s okay to delete the tmp files. Most of the time that’s okay and 
you should type "yes". When you say that, JOVE removes all traces of those buffers and you 
won’t be able to look at them again. (If you recovered some buffers they will still be around, 
so don’t worry.) So, if you’re not sure whether you’ve gotten all the buffers, you should 
answer "no" so that you’ll be able to run JOVE_RECOVER again at a later time (presumably 
after you’ve figured out which ones you want to save). 

If you type A C at any time other than when you’re printing a file to the terminal, 
JOVE_RECOVER will exit without a word. If you do this but wish you hadn’t, just type 
"jove -r" to the shell again, and you will be put back with no loss. 

A SAMPLE SESSION 

% jove -r 

Found 2 buffers (last updated: Sun Apr 14 14:13:38 1985). 

(Type ’?’ for options): list 

1) buffer recover. 1 "/u/staff/jpay/doc/recover.l" (120 lines) 

2) buffer recover.c "/u/staff/jpay/jove/recover.c" (635 lines) 
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(Type ’?’ for options): get recover. 1 recover .save 
"recover.save" 53 lines, 1821 characters. 

(Type ’?’ for options): quit 
Should I delete the tmp files? yes 

% 

Here I "got" the buffer recover. 1 and restored it to the temporary file recover.save. It’s gen¬ 
erally a good idea to recover buffers to temporary files and then compare them to the original 
or at least look them over before putting them back in their real name. This is just in case 
you were restoring what you thought you were restoring. 

FILES 

/tmp - where temporary files are stored. 

SEE ALSO 

JOVE(l) - for this to make any sense to you. 

DIAGNOSTICS 

JOVE_RECOVER diagnostics are meant to be self-explanatory. 

BUGS 

It works well enough... 

AUTHOR 

Jonathan Payne 
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NAME 

kermit - kermit file transfer 

SYNOPSIS 

kermit [ option ...] [file ...] 

DESCRIPTION 

Kermit is a public domain file transfer program that allows files to be moved between 
machines of many different operating systems and architectures. This man page describes ver¬ 
sion 4C of the program. 

Arguments are optional. If Kermit is executed without arguments, it will enter command 
mode. Otherwise, kermit will read the arguments off the command line and interpret them. 

The following notation is used in command descriptions: 

fn A Unix file specification, possibly containing either of the "wildcard" characters V or 

T (V matches all character strings, ’?’ matches any single character). 

fnl A Unix file specification which may not contain V or ’?’. 

rjn A remote file specification in the remote system’s own syntax, which may denote a 
single file or a group of files. 

rfnl A remote file specification which should denote only a single file, 

n A decimal number between 0 and 94. 

c A decimal number between 0 and 127 representing the value of an ASCII character. 

cc A decimal number between 0 and 31, or else exactly 127, representing the value of an 

ASCII control character. 

[ ] Any field in square braces is optional. 

{ x,y,z } Alternatives are listed in curly braces. 

Kermit command line options may specify either actions or settings. If Kermit is invoked 
with a command line that specifies no actions, then it will issue a prompt and begin interac¬ 
tive dialog. Action options specify either protocol transactions or terminal connection. 

COMMAND LINE OPTIONS 

-s fn Send the specified file or files. If fn contains wildcard (meta) characters, the Unix 
shell expands it into a list. If fn is then Kermit sends from standard input, which 
must come from a file: 

kermit -s - < foo.bar 

or a parallel process: 

Is -1 | kermit -s - 

You cannot use this mechanism to send terminal typein. If you want to send a file 
whose name is "-" you can precede it with a path name, as in 

kermit -s ./- 

—r Receive a file or files. Wait passively for files to arrive. 
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-k Receive (passively) a file or files, sending them to standard output. This option can 
be used in several ways: 

kermit -k 

Displays the incoming files on your screen; to be used only in "local mode" (see 
below). 

kermit -k > fnl 

Sends the incoming file or files to the named file, fnl. If more than one file arrives, all 
are concatenated together into the single file fnl. 

kermit -k | command 

Pipes the incoming data (single or multiple files) to the indicated command, as in 
kermit -k | sort > sorted.stuff 

—a fnl If you have specified a file transfer option, you may specify an alternate name for a 
single file with the -a option. For example, 

kermit -s foo -a bar 

sends the file foo telling the receiver that its name is bar. If more than one file 
arrives or is sent, only the first file is affected by the -a option: 

kermit -ra baz 

stores the first incoming file under the name baz. 

—x Begin server operation. May be used in either local or remote mode. 

Before proceeding, a few words about remote and local operation are necessary. Kermit is 
"local" if it is running on a PC or workstation that you are using directly, or if it is running 
on a multiuser system and transferring files over an external communication line — not your 
job’s controlling terminal or console. Kermit is remote if it is running on a multiuser system 
and transferring files over its own controlling terminal’s communication line, connected to 
your PC or workstation. 

If you are running Kermit on a PC, it is in local mode by default, with the "back port" desig¬ 
nated for file transfer and terminal connection. If you are running Kermit on a multiuser 
(timesharing) system, it is in remote mode unless you explicitly point it at an external line for 
file transfer or terminal connection. The following command sets Kermit 's "mode": 

—1 dev Line — Specify a terminal line to use for file transfer and terminal connection, as in 
kermit -1 /dev/ttyi5 

When an external line is being used, you might also need some additional options for success¬ 
ful communication with the remote system: 

—b n Baud — Specify the baud rate for the line given in the —1 option, as in 
kermit -1 /dev/ttyi5 -b 9600 

This option should always be included with the —1 option, since the speed of an exter¬ 
nal line is not necessarily what you expect. 

-p x Parity — e, o, m, s, n (even, odd, mark, space, or none). If parity is other than none, 
then the 8th-bit prefixing mechanism will be used for transferring 8-bit binary data, 
provided the opposite Kermit agrees. The default parity is none. 

-t Specifies half duplex, line turnaround with XON as the handshake character. 
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The following commands may be used only with a Kermit which is local — either by default 

or else because the -1 option has been specified. 

—g r/n Actively request a remote server to send the named file or files; r/n is a file 
specification in the remote host’s own syntax. If fn happens to contain any special 
shell characters, like V, these must be quoted, as in 

kermit -g x\*.\? 

—f Send a ’finish’ command to a remote server. 

—c Establish a terminal connection over the specified or default communication line, 

before any protocol transaction takes place. Get back to the local system by typing 
the escape character (normally Control-Backslash) followed by the letter ’c’. 

—n Like —c, but after a protocol transaction takes place; -c and —n may both be used in 

the same command. The use of -n and —c is illustrated below. 


On a timesharing system, the —1 and — b options will also have to be included with the -r, -k, 
or —s options if the other Kermit is on a remote system. 


If kermit is in local mode, the screen (stdout) is continously updated to show the progress of 
the file transer. A dot is printed for every four data packets, other packets are shown by type 
(e.g. ’S’ for Send-Init), ’T’ is printed when there’s a timeout, and '%' for each retransmission. 
In addition, you may type (to stdin) certain "interrupt” commands during file transfer: 

Control-F: Interrupt the current File, and go on to the next (if any). 

Control-B: Interrupt the entire Batch of files, terminate the transaction. 

Control-R: Resend the current packet 


Control-A: 


Display a status report for the current transaction. 


These interrupt characters differ from the ones used in other Kermit implementations to avoid 
conflict with Unix shell interrupt characters. With System III and System V implementations 
of Unix, interrupt commands must be preceeded by the escape character (e.g. control-\). 

Several other command-line options are provided: 

—i Specifies that files should be sent or received exactly "as is” with no conversions. 

This option is necessary for transmitting binary files. It may also be used to slightly 
boost efficiency in Unix-to-Unix transfers of text files by eliminating CRLF/newline 
conversion. 

—w Write-Protect — Avoid filename collisions for incoming files. 

—q Quiet — Suppress screen update during file transfer, for instance to allow a file 

transfer to proceed in the background. 

—d Debug — Record debugging information in the file debug.log in the current direc¬ 

tory. Use this option if you believe the program is misbehaving, and show the 
resulting log to your local Kermit maintainer. 

—h Help — Display a brief synopsis of the command line options. 

The command line may contain no more than one protocol action option. 

INTERACTIVE OPERATION 

Kermit 's interactive command prompt is "C-Kermit>". In response to this prompt, you may 
type any valid command. Kermit executes the command and then prompts you for another 
command. The process continues until you instruct the program to terminate. 
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Commands begin with a keyword, normally an English verb, such as "send". You may omit 
trailing characters from any keyword, so long as you specify sufficient characters to distin¬ 
guish it from any other keyword valid in that field. Certain commonly-used keywords (such 
as "send", "receive", "connect") have special non-unique abbreviations ("s" for "send", "r" for 
"receive", "c" for "connect"). 

Certain characters have special functions in interactive commands: 

? Question mark, typed at any point in a command, will produce a message explaining 

what is possible or expected at that point. Depending on the context, the message 
may be a brief phrase, a menu of keywords, or a list of files. 

ESC (The Escape or Altmode key) — Request completion of the current keyword or 
filename, or insertion of a default value. The result will be a beep if the requested 
operation fails. 

DEL (The Delete or Rubout key) — Delete the previous character from the command. 
You may also use BS (Backspace, Control-H) for this function. 

(Control-W) — Erase the rightmost word from the command line. 

~U (Control-U) — Erase the entire command. 

*R (Control-R) — Redisplay the current command. 

SP (Space) — Delimits fields (keywords, filenames, numbers) within a command. HT 
(Horizontal Tab) may also be used for this purpose. 

CR (Carriage Return) — Enters the command for execution. LF (Linefeed) or FF 
(formfeed) may also be used for this purpose. 

\ (Backslash) — Enter any of the above characters into the command, literally. To 

enter a backslash, type two backslashes in a row (\\). A single backslash immedi¬ 
ately preceding a carriage return allows you to continue the command on the next 
line. 


You may type the editing characters (DEL, *W, etc) repeatedly, to delete all the way back to 
the prompt. No action will be performed until the command is entered by typing carriage 
return, linefeed, or formfeed. If you make any mistakes, you will receive an informative error 
message and a new prompt — make liberal use of ’?’ and ESC to feel your way through the 
commands. One important command is "help" — you should use it the first time you run 
Kermit. 

Interactive Kermit accepts commands from files as well as from the keyboard. When you 
enter interactive mode, Kermit looks for the file .kermrc in your home or current directory 
(first it looks in the home directory, then in the current one) and executes any commands it 
finds there. These commands must be in interactive format, not Unix command-line format. 
A "take" command is also provided for use at any time during an interactive session. Com¬ 
mand files may be nested to any reasonable depth. 

Here is a brief list of Kermit interactive commands: 

! Execute a Unix shell command. 


bye 

close 

connect 

cwd 


Terminate and log out a remote Kermit server. 
Close a log file. 

Establish a terminal connection to a remote system. 
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dial 

directory 

echo 

exit 

finish 

get 

help 

log 

quit 

receive 

remote 

script 

send 

server 

set 

show 

space 

statistics 

take 


Dial a telephone number. 

Display a directory listing. 

Display arguments literally. 

Exit from the program, closing any open logs. 

Instruct a remote Kermit server to exit, but not log out. 

Get files from a remote Kermit server. 

Display a help message for a given command. 

Open a log file — debugging, packet, session, transaction. 
Same as ’exit’. 

Passively wait for files to arrive. 

Issue file management commands to a remote Kermit server. 
Execute a login script with a remote system. 

Send files. 

Begin server operation. 

Set various parameters. 

Display values of ’set’ parameters. 

Display current disk space usage. 

Display statistics about most recent transaction. 

Execute commands from a file. 


The ’set’ parameters 

block-check 

delay 

duplex 

escape-character 

file 

flow-control 

handshake 

line 

modem-dialer 

parity 

prompt 

receive 

send 


are: 


Level of packet error detection. 

How long to wait before sending first packet. 

Specify which side echoes during ’connect’. 

Character to prefix "escape commands" during ’connect’ 
Set various file parameters. 

Communication line full-duplex flow control. 
Communication line half-duplex turnaround character. 
Communication line device name. 

Type of modem-dialer on communication line. 
Communication line character parity. 

Change the Kermit program’s prompt. 

Set various parameters for inbound packets. 

Set various parameters for outbound packets. 
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speed 


Communication line speed. 


The ’remote’ commands are: 

cwd Change remote working directory. 

delete Delete remote files. 

directory Display a listing of remote file names. 

help Request help from a remote server. 

host Issue a command to the remote host in its own command language, 

space Display current disk space usage on remote system, 

type Display a remote file on your screen, 

who Display who’s logged in, or get information about a user. 


FILES 

$HOME/.kermrc Kermit initialization commands 
./.kermrc more Kermit initialization commands 

SEE ALSO 

cu(lC), uucp(lC) 

Frank da Cruz and Bill Catchings, Kermit User’s Guide, Columbia University, 6th Edition 

DIAGNOSTICS 

The diagnostics produced by Kermit itself are intended to be self-explanatory. 


BUGS 

See recent issues of the Info-Ivermit digest (on ARPANET or Usenet), or the file ckuker.bwr, 
for a list of bugs. 

COPYRIGHT 

Copyright (C) 1985, Trustess of Columbia University in the City of New York. Permission is 
granted to any individual or institution to use, copy, or redistribute this (Kermit) software so 
long as it is not sold for profit, provided this copyright notice is retained. 
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NAME 

kill - terminate a process with extreme prejudice 

SYNOPSIS 

kill [ —sig ] processid ... 

kill -1 

DESCRIPTION 

Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or 
number preceded by is given as first argument, that signal is sent instead of terminate (see 
sigvec(2)). The signal names are listed by ‘kill -1’, and are as given in /usr/include/signal.h, 
stripped of the common SIG prefix. 

The terminate signal will kill processes that do not catch the signal; ‘kill -9 ...’ is a sure kill, 
as the KILL (9) signal cannot be caught. By convention, if process number 0 is specified, all 
members in the process group (i.e. processes resulting from the current login) are signaled (but 
beware: this works only if you use sh( 1); not if you use cs/i(l).) The killed processes must 
belong to the current user unless he is the super-user. 

The process number of an asynchronous process started with is reported by the shell. 
Process numbers can also be found by using Kill is a built-in to cs/i(l); it allows job specifiers 
so process id’s are not as often used as kill arguments. See cs/i(l) for details. 

SEE ALSO 

csh(l), ps(l), kill(2), sigvec(2) 


BUGS 

An option to kill process groups ala killpg( 2) should be provided; a replacement for “kill 0” for 
csh( 1) users should be provided. 
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NAME 

last - indicate last logins of users and teletypes 

SYNOPSIS 

last [ -N ] [ name ... ] [ tty ... ] 

DESCRIPTION 

Last will look back in the wtmp file which records all logins and logouts for information about 
a user, a teletype or any group of users and teletypes. Arguments specify names of users or 
teletypes of interest. Names of teletypes may be given fully or abbreviated. For example ‘last 
O’ is the same as ‘last ttyO’. If multiple arguments are given, the information which applies to 
any of the arguments is printed. For example ‘last root console’ would list all of "root’s" ses¬ 
sions as well as all sessions on the console terminal. Last will print the sessions of the 
specified users and teletypes, most recent first, indicating the times at which the session 
began, the duration of the session, and the teletype which the session took place on. If the 
session is still continuing or was cut short by a reboot, last so indicates. 

The pseudo-user reboot logs in at reboots of the system, thus 
last reboot 

will give an indication of mean time between reboot. 

Last with no arguments prints a record of all logins and logouts, in reverse order. The -N 
option limits the report to N lines. 

If last is interrupted, it indicates how far the search has progressed in wtmp. If interrupted 
with a quit signal (generated by a control-\) last indicates how far the search has progressed 
so far, and the search continues. 


FILES 

/usr/adm/wtmp login data base 

/usr/adm/shutdownlog which records shutdow-ns and reasons for same 

SEE ALSO 

wtmp(5), ac(8), lastcomm(l) 

AUTHOR 

Howard Ivatseff 
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( NAME 

lastcomm - show last commands executed in reverse order 

SYNOPSIS 

lastcomm [ command name ] ... [user name] ... [terminal name] ... 

DESCRIPTION 

Lastcomm gives information on previously executed commands. With no arguments, 
lastcomm prints information about all the commands recorded during the current accounting 
file’s lifetime. If called with arguments, only accounting entries with a matching command 
name, user name, or terminal name are printed. So, for example, 
lastcomm a.out root ttydO 

would produce a listing of all the executions of commands named a.out by user root on the 
terminal ttydO. 

For each process entry, the following are printed. 

The name of the user who ran the process. 

Flags, as accumulated by the accounting facilities in the system. 

The command name under which the process was called. 

The amount of cpu time used by the process (in seconds). 

The time the process exited. 

The flags are encoded as follows: “S” indicates the command was executed by the super-user, 
“F” indicates the command ran after a fork, but without a following exec , “D” indicates the 
command terminated with the generation of a core file, and “X” indicates the command was 
terminated with the signal SIGTERM. 

( SEE ALSO 

last(l), sigvec(2), acct(5), core(5) 
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NAME 

Id - link editor 

SYNOPSIS 

Id [ option ] ... file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves external references, and searches 
libraries. In the simplest case several object files are given, and Id combines them, producing 
an object module which can be either executed or become the input for a further Id run. (In 
the latter case, the —r option must be given to preserve the relocation bits.) The output of Id 
is left on a.out. This file is made executable only if no errors occurred during the load. 

The argument routines are concatenated in the order specified. The entry point of the output 
is the beginning of the first routine (unless the -e option is specified). 

If any argument is a library, it is searched exactly once at the point it is encountered in the 
argument list. Only those routines defining an unresolved external reference are loaded. If a 
routine from a library references another routine in the library, and the library has not been 
processed by ranlib(l), the referenced routine must appear after the referencing routine in the 
library. Thus the order of programs within libraries may be important. The first member of 

a library should be a file named ‘_.SYMDEF’, which is understood to be a dictionary for the 

library as produced by ranlib(l)-, the dictionary is searched iteratively to satisfy as many refer¬ 
ences as possible. 

The symbols ‘_etext’, ‘_edata’ and Lend’ (‘etext’, ‘edata’ and ‘end’ in C) are reserved, and if 
referred to, are set to the first location above the program, the first location above initialized 
data, and the first location above all data respectively. It is erroneous to define these sym¬ 
bols. 

Ld understands several options. Except for —1, they should appear before the file names. 

—A This option specifies incremental loading, i.e. linking is to be done in a manner so 

that the resulting object may be read into an already executing program. The next 
argument is the name of a file whose symbol table will be taken as a basis on which to 
define additional symbols. Only newly linked material will be entered into the text 
and data portions of a.out, but the new symbol table will reflect every symbol defined 
before and after the incremental load. This argument must appear before any other 
object file in the argument list. The —T option may be used as well, and will be taken 
to mean that the newly linked segment will commence at the corresponding address 
(which must be a multiple of 1024). The default value is the old value of _end. 

—D Take the next argument as a hexadecimal number and pad the data segment with zero 

bytes to the indicated length. 

— d Force definition of common storage even if the -r flag is present. 

—e The following argument is taken to be the name of the entry point of the loaded pro¬ 

gram; location 0 is the default. 

-lx This option is an abbreviation for the library name ‘/lib/libx.a’, where x is a string. If 
that does not exist, Id tries ‘/usr/lib/libx.a’ A library is searched when its name is 
encountered, so the placement of a -1 is significant. 

—M produce a primitive load map, listing the names of the files which will be loaded. 

-N Do not make the text portion read only or sharable. (Use "magic number" 0407.) 
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—n Arrange (by giving the output file a 0410 "magic number") that when the output file is 

executed, the text portion will be read-only and shared among all users executing the 
file. This involves moving the data areas up to the first possible 1024 byte boundary 
following the end of the text. 

—o The name argument after -o is used as the name of the Id output file, instead of 

a.out. 

—r Generate relocation bits in the output file so that it can be the subject of another Id 

run. This flag also prevents final definitions from being given to common symbols, 
and suppresses the ‘undefined symbol’ diagnostics. 

-S ‘Strip’ the output by removing all symbols except locals and globals. 

—s ‘Strip’ the output, that is, remove the symbol table and relocation bits to save space 

(but impair the usefulness of the debuggers). This information can also be removed by 
stn'p(l). 

—T The next argument is a hexadecimal number which sets the text segment origin. The 

default origin is 0. 

—t ("trace") Print the name of each file as it is processed. 

—u Take the following argument as a symbol and enter it as undefined in the symbol 

table. This is useful for loading wholly from a library, since initially the symbol table 
is empty and an unresolved reference is needed to force the loading of the first routine. 

—U Suppress "Undefined symbol" messages. 

—X Save local symbols except for those whose names begin with ‘L’. This option is used 
by cc(l) to discard internally-generated labels while retaining symbols local to rou¬ 
tines. 

—x Do not preserve local (non-.globl) symbols in the output symbol table; only enter 
external symbols. This option saves some space in the output file. 

—ysym Indicate each file in which sym appears, its type and whether the file defines or refer¬ 
ences it. Many such options may be given to trace many symbols. (It is usually neces¬ 
sary to begin sym with an ‘_’, as external C, FORTRAN and Pascal variables begin 

with underscores.) 

-z Arrange for the process to be loaded on demand from the resulting executable file (413 
format) rather than preloaded. This is the default. Results in a 1024 byte header on 
the output file followed by a text and data segment each of which have size a multiple 
of 1024 bytes (being padded out with nulls in the file if necessary). With this format 
the first few BSS segment symbols may actually appear (from the output of s* 2 e(l)) to 
live in the data segment; this to avoid wasting the space resulting from data segment 
size roundup. 

FILES 

/lib/lib*.a 
/usr/lib/lib*.a 
/ usr/local/lib/lib*, a 
a.out 

SEE ALSO 

as(l), ar(l), cc(l), ranlib(l) 


libraries 
more libraries 
still more libraries 
output file 
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BUGS 

There is no way to force data to be page aligned. Ld pads images which are to be demand 
loaded from the file system to the next page boundary to avoid a bug in the system. 
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NAME 

learn - computer aided instruction about UNIX 

SYNOPSIS 

learn [ —directory ] [ subject [ lesson ] ] 

DESCRIPTION 

Learn gives Computer Aided Instruction courses and practice in the use of UNIX, the C Shell, 
and the Berkeley text editors. To get started simply type learn. The program will ask ques¬ 
tions to find out what you want to do. Some questions may be bypassed by naming a sub¬ 
ject, and more yet by naming a lesson. You may enter the lesson as a number that learn 
gave you in a previous session. If you do not know the lesson number, you may enter the les¬ 
son as a word, and learn will look for the first lesson containing it. If the lesson is learn 
prompts for each lesson; this is useful for debugging. 

The subject ’s presently handled are 

files 

editor 

vi 

morefiles 

macros 

eqn 

C 

There are a few special commands. The command ‘bye’ terminates a learn session and ‘where’ 
tells you of your progress, with ‘where m’ telling you more. The command ‘again’ re-displays 
the text of the lesson and ‘again lessoji ’ lets you review lesson. 

The —directory option allows one to exercise a script in a nonstandard place. 


FILES 

/usr/lib/learn subtree for all dependent directories and files 
/usr/tmp/pl* playpen directories 


SEE ALSO 

csh(l), ex(l) 


BUGS 

The main strength of learn, that it asks the student to use the real UNIX, also makes possible 
baffling mistakes. It is helpful, especially for nonprogrammers, to have a UNIX initiate near 
at hand during the first sessions. 

Occasionally lessons are incorrect, sometimes because the local version of a command operates 
in a non-standard way. Such lessons may be skipped with the ‘skip’ command, but it takes 
some sophistication to recognize the situation. 

To find a lesson given as a word, learn does a simple fgrep( 1) through the lessons. It is 
unclear whether this sort of subject indexing is better than none. 

Spawning a new shell is required for each of many user and internal functions. 
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( NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [ hhmm ] 


DESCRIPTION 

Leave waits until the specified time, then reminds you that you have to leave. You are rem¬ 
inded 5 minutes and 1 minute before the actual time, at the time, and every minute 
thereafter. When you log off, leave exits just before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour clock). 
All times are converted to a 12 hour clock, and assumed to be in the next 12 hours. 

If no argument is given, leave prompts with "When do you have to leave?". A reply of newline 
causes leave to exit, otherwise the reply is assumed to be a time. This form is suitable for 
inclusion in a .login or .profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or 
use “kill -9” giving its process id. 


SEE ALSO 

calendar(l) 

AUTHOR 

Mark Horton 


c 
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NAME 

lex - generator of lexical analysis programs 

SYNOPSIS 

lex [ —tvfn ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analyis of text. The input files (standard 
input default) contain regular expressions to be searched for, and actions written in C to be 
executed when expressions are found. 

A C source program, ’lex.yy.c’ is generated, to be compiled thus: 
cc lex.yy.c -11 

This program, when run, copies unrecognized portions of the input to the output, and exe¬ 
cutes the associated C action for each regular expression that is recognized. 

The options have the following meanings. 

—t Place the result on the standard output instead of in file "lex.yy.c". 

—v Print a one-line summary of statistics of the generated analyzer. 

— n Opposite of —v; -n is default. 

—f "Faster" compilation: don’t bother to pack the resulting tables; limited to small pro¬ 

grams. 

EXAMPLE 

lex lex commands 

would draw lex instructions from the file lexcommands, and place the output in lex.yy.c 

%% 

A-Z]putchar(yytext[0]+ 'a - 'A'); 

+$ 

]+putchar(' '); 

is an example of a lex program that would be put into a lex command file. This program con¬ 
verts upper case to lower, removes blanks at the end of lines, and replaces multiple blanks by 
single blanks. 

SEE ALSO 

yacc(l), sed(l) 

M. E. Lesk and E. Schmidt, LEX - Lexical Analyzer Generator 
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NAME 

lint - a C program verifier 

SYNOPSIS 

lint [ —abchnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files which are likely to be bugs, or non¬ 
portable, or wasteful. It also checks the type usage of the program more strictly than the 
compilers. Among the things which are currently found are unreachable statements, loops not 
entered at the top, automatic variables declared and not used, and logical expressions whose 
value is constant. Moreover, the usage of functions is checked to find functions which return 
values in some places and not in others, functions called with varying numbers of arguments, 
and functions whose values are not used. 

By default, it is assumed that all the files are to be loaded together; they are checked for 
mutual compatibility. Function definitions for certain libraries are available to lint; these 
libraries are referred to by a conventional name, such as ‘-lm’, in the style of ld( 1). Argu¬ 
ments ending in .In are also treated as library files. To create lint libraries, use the -C 
option: 

lint -Cfoo files . . . 

where files are the C sources of library foo. The result is a file llib-lfoo.ln in the correct library 
format suitable for linting programs using foo. 

Any number of the options in the following list may be used. The -D, -U, and -I options of 
cc(l) are also recognized as separate arguments. 

p Attempt to check portability to the ZBA/and GCOS dialects of C. 

h Apply a number of heuristic tests to attempt to intuit bugs, improve style, and reduce 

waste. 

b Report break statements that cannot be reached. (This is not the default because, 
unfortunately, most lex and many yacc outputs produce dozens of such comments.) 

v Suppress complaints about unused arguments in functions, 
x Report variables referred to by extern declarations, but never used, 

a Report assignments of long values to int variables, 

c Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not defined, or defined and 
not used (this is suitable for running lint on a subset of files out of a larger program). 

n Do not check compatibility against the standard library. 

z Do not complain about structures that are never defined (e.g. using a structure 
pointer without knowing its contents.). 


Exit( 2) and other functions which do not return are not understood; this causes various lies. 
Certain conventional comments in the C source will change the behavior of lint: 
/♦NOTREACHED*/ 

at appropriate points stops comments about unreachable code. 
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/♦VARARGSn*/ 

suppresses the usual checking for variable numbers of arguments in the following func¬ 
tion declaration. The data types of the first n arguments are checked; a missing n is 
taken to be 0. 

/ *NOSTRICT*/ 

shuts off strict type checking in the next expression. 

/♦ARGSUSED*/ 

turns on the —v option for the next function. 

/*LINTLIBRARY*/ 

at the beginning of a file shuts off complaints about unused functions in this file. 


AUTHOR 

S.C. Johnson. Lint library construction implemented by Edward Wang. 


FILES 

/usr/lib/lint/lint[l2] 

/ usr/lib/lin t/llib-lc.ln 
/ usr/lib/lint/llib-lc 
/usr/lib/lint/llib-port.ln 
/ usr/lib/lin t/llib-port 
llib-l*.ln 


programs 

declarations for standard functions 
human readable version of above 
declarations for portable functions 
human readable . . . 
library created with -C 


SEE ALSO 

cc(l) 

S. C. Johnson, Lint, a C Program Checker 


BUGS 

There are some things you just can’t get lint to shut up about. 
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NAME 

lisp - lisp interpreter 

SYNOPSIS 

lisp 

DESCRIPTION 

Lisp is a lisp interpreter for a dialect which closely resembles MIT’s MACLISP. This lisp, 
known as FRANZ LISP, features an I/O facility which allows the user to change the input and 
output syntax, add macro characters, and maintain compatibility with upper-case only lisp 
systems; infinite precision integer arithmetic, and an error facility which allows the user to 
trap system errors in many different ways. Interpreted functions may be mixed with code 
compiled by liszt{\) and both may be debugged using the “Joseph Lister” trace package. A 
lisp containing compiled and interpreted code may be dumped into a file for later use. 

There are too many functions to list here; one should refer to the manuals listed below. 
AUTHORS 

An early version was written by Jeff Levinsky, Mike Curry, and John Breedlove. Keith 
Sklower wrote and is maintaining the current version, with the assistance of John Foderaro. 
The garbage collector was implemented by Bill Rowan. 


FILES 

/usr/lib/lisp/trace.l Joseph Lister trace package 

/usr/lib/lisp/toplevel.l top level read-eval-print loop 

SEE ALSO 

liszt(l), lxref(l) 

‘FRANZ Lisp Manual, Version 1’ by John Iv. Foderaro 
Maclisp Manual 


BUGS 

The error system is in a state of flux and not all error messages are as informative as they 
could be. 
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NAME 

liszt - compile a Franz Lisp program 

SYNOPSIS 

liszt [ — mpqruwxCQST ] [ —e form ] [ -o objfile ] [ name ] 

DESCRIPTION 

Liszt takes a file whose names ends in ‘.1’ and compiles the FRANZ LISP code there leaving an 
object program on the file whose name is that of the source with ‘.o’ substituted for ‘.1’. 

The following options are interpreted by liszt. 

—e Evaluate the given form before compilation begins. 

—m Compile a MACLISP file, by changing the readtable to conform to MACLISP syntax and 

including a macro-defined compatibility package. 

—o Put the object code in the specified file, rather than the default ‘.o’ file. 

—p places profiling code at the beginning of each non-local function. If the lisp system is 

also created with profiling in it, this allows function calling frequency to be determined 
(see pro/(l).) 

—q Only print warning and error messages. Compilation statistics and notes on correct 

but unusual constructs will not be printed. 

—r place bootstrap code at the beginning of the object file, which when the object file is 

executed will cause a lisp system to be invoked and the object file fasl’ed in. 

-u Compile a UCI-lispfile, by changing the readtable to conform to UCI-Lisp syntax and 
including a macro-defined compatibility package. 

—w Suppress warning diagnostics. 

-x Create a lisp cross reference file with the same name as the source file but with ‘.x’ 
appended. The program Ixref(l) reads this file and creates a human readable cross 
reference listing. 

—C put comments in the assembler output of the compiler. Useful for debugging the com¬ 
piler. 

-Q Print compilation statistics and warn of strange constructs. This is the default. 

—S Compile the named program and leave the assembler-language output on the 
corresponding file suffixed ‘.s’. This will also prevent the assembler language file from 
being assembled. 

-T send the assembler output to standard output. 

If no source file is specified, then the compiler will run interactively. You will find yourself 
talking to the lisp(l) top-level command interpreter. You can compile a file by using the 
function liszt (an nlambda) with the same arguments as you use on the command line. For 
example to compile ‘foo’, a MACLISP file, you would use: 

(liszt -m foo) 

Note that liszt supplies the “.1” extension for you. 


FILES 

/ usr/lib/lisp / machacks.l 
/usr/lib/lisp/syscall .1 
/ usr/lib/lisp/ucifnc.l 


MACLISP compatibility package 
macro definitions of Unix system calls 
UCI Lisp compatibility package 
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AUTHOR 

John Foderaro 

SEE ALSO 

lisp(l), lxref(l) 
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NAME 

In - make links 

SYNOPSIS 

In [ -s ] namel [ name2 ] 

In name ... directory 

DESCRIPTION 

A link is a directory entry referring to a file; the same file (together with its size, all its protec¬ 
tion information, etc.) may have several links to it. There are two kinds of links: hard links 
and symbolic links. 

By default In makes hard links. A hard link to a file is indistinguishable from the original 
directory entry; any changes to a file are effective independent of the name used to reference 
the file. Hard links may not span file systems and may not refer to directories. 

The —s option causes In to create symbolic links. A symbolic link contains the name of the 
file to which it is linked. The referenced file is used when an open(2) operation is performed 
on the link. A stat{ 2) on a symbolic link will return the linked-to file; an lstat( 2) must be 
done to obtain information about the link. The readlink( 2) call may be used to read the con¬ 
tents of a symbolic link. Symbolic links may span file systems and may refer to directories. 

Given one or two arguments, In creates a link to an existing file namel . If name2 is given, the 
link has that name; name2 may also be a directory in which to place the link; otherwise it is 
placed in the current directory. If only the directory is specified, the link will be made to the 
last component of namel. 

Given more than two arguments, In makes links to all the named files in the named directory. 
The links made will have the same name as the files being linked to. 

SEE ALSO 

rm(l), cp(l), mv(l), link(2), readlink(2), stat(2), symlink(2) 
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NAME 

lock - reserve a terminal 


SYNOPSIS 

lock 


DESCRIPTION 

Lock requests a password from the user, then prints ’LOCKED" on the terminal and refuses 
to relinquish the terminal until the password is repeated. If the user forgets the password, he 
has no other recourse but to login elsewhere and kill the lock process. 


AUTHOR 

Kurt Shoens 


BUGS 

Should timeout after 15 minutes. 
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NAME 

login - sign on 


SYNOPSIS 

login [ username ] 

DESCRIPTION 

The login command is used when a user initially signs on, or it may be used at any time to 
change from one user to another. The latter case is the one summarized above and described 
here. See “How to Get Started” for how to dial up initially. 

If login is invoked without an argument, it asks for a user name, and, if appropriate, a pass¬ 
word. Echoing is turned off (if possible) during the typing of the password, so it will not 
appear on the written record of the session. 

After a successful login, accounting files are updated and the user is informed of the existence 
of mail, and the message of the day is printed, as is the time he last logged in (unless he has a 
“.hushlogin” file in his home directory - this is mostly used to make life easier for non-human 
users, such as uucp). 

Login initializes the user and group IDs and the working directory, then executes a command 
interpreter (usually sh(l)) according to specifications found in a password file. Argument 0 of 
the command interpreter is “-sh”, or more generally the name of the command interpreter 
with a leading dash (“-”) prepended. 

Login also initializes the environment environ{ 7) with information specifying home directory, 
command interpreter, terminal type (if available) and user name. 

If the file /etc/nologin exists login prints its contents on the user’s terminal and exits. This is 
used by shutdown{ 8) to stop users logging in when the system is about to go down. 

Login is recognized by sh{ 1) and csh( 1) and executed directly (without forking). 


FILES 

/etc/utmp 

/ usr/adm/w r tmp 

/usr/spool/mail/* 

/etc/motd 

/etc/passwd 

/etc/nologin 

.hushlogin 

/etc/securetty 


accounting 

accounting 

mail 

message-of-the-d ay 

password file 

stops logins 

makes login quieter 

lists ttys that root may log in on 


SEE ALSO 

init(8), getty(8), mail(l), passwd(l), passwd(5), environ(7), shutdown(8) 


DIAGNOSTICS 

“Login incorrect,” if the name or the password is bad. 

“No Shell”, “cannot open password file”, “no directory”: consult a programming counselor. 

BUGS 

An undocumented option, -r is used by the remote login server, rlogind( 8C) to force login to 
enter into an initial connection protocol. 
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NAME 

look - find lines in a sorted list 

SYNOPSIS 

look [ —df ] string [ file ] 

DESCRIPTION 

Look consults a sorted file and prints all lines that begin with string. It uses binary search. 
The options d and f affect comparisons as in sorf(l): 

d ‘Dictionary’ order: only letters, digits, tabs and blanks participate in comparisons, 
f Fold. Upper case letters compare equal to lower case. 

If no file is specified, /usr/diet/words is assumed with collating sequence — df. 


FILES 

/usr/dict/words 

SEE ALSO 

sort(l), grep(l) 


ICON INTERNATIONAL 


1 



LOOKBIB (1) 


USER COMMANDS 


LOOKBIB (1) 


NAME 

indxbib, lookbib - build inverted index for a bibliography, find references in a bibliography 

SYNOPSIS 

indxbib database ... 
lookbib database 

DESCRIPTION 

Indxbib makes an inverted index to the named databases (or files) for use by lookbib( 1) and 
re/er(l). These files contain bibliographic references (or other kinds of information) separated 
by blank lines. 

A bibliographic reference is a set of lines, constituting fields of bibliographic information. 
Each field starts on a line beginning with a followed by a key-letter, then a blank, and 
finally the contents of the field, which may continue until the next line starting with 

Indxbib is a shell script that calls /usr/lib/refer/mkey and /usr/lib/refer/inv. The first pro¬ 
gram, mkey, truncates words to 6 characters, and maps upper case to lower case. It also dis¬ 
cards words shorter than 3 characters, words among the 100 most common English words, 
and numbers (dates) < 1900 or > 2000. These parameters can be changed; see page 4 of the 
Refer document by Mike Lesk. The second program, inv, creates an entry file (.ia), a posting 
file (.ib), and a tag file (.ic), all in the working directory. 

Lookbib uses an inverted index made by indxbib to find sets of bibliographic references. It 
reads keywords typed after the “>” prompt on the terminal, and retrieves records containing 
all these keywords. If nothing matches, nothing is returned except another “>” prompt. 

It is possible to search multiple databases, as long as they have a common index made by 
indxbib. In that case, only the first argument given to indxbib is specified to lookbib. 

If lookbib does not find the index files (the .i[abc] files), it looks for a reference file with the 
same name as the argument, without the suffixes. It creates a file with a ’.ig’ suffix, suitable 
for use with fgrep. It then uses this fgrep file to find references. This method is simpler to use, 
but the .ig file is slower to use than the ,i[abc] files, and does not allow the use of multiple 
reference files. 


FILES 

x.ia, x.ib, x.ic, where x is the first argument, or if these are not present, then x.ig, x 

SEE ALSO 

refer(l), addbib(l), sortbib(l), roffbib(l), lookbib(l) 

BUGS 

Probably all dates should be indexed, since many disciplines refer to literature written in the 
1800s or earlier. 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file ... 

DESCRIPTION 

The input is one or more object or library archive (see or(l)) files. The standard output is a 
list of pairs of object file names, meaning that the first file of the pair refers to external 
identifiers defined in the second. The output may be processed by tsort( 1) to find an ordering 
of a library suitable for one-pass access by ld( 1). 

This brash one-liner intends to build a new library from existing ‘.o’ files, 
ar cr library ' lorder *.o | tsort' 

The need for lorder may be vitiated by use of ranltb(l), which converts an ordered archive 
into a randomly accessed library. 


FILES 

♦symref, *symdef 

nm(l), sed(l), sort(l), join(l) 


SEE ALSO 

tsort(l), ld(l), ar(l), ranlib(l) 


BUGS 

The names of object files, in and out of libraries, must end with ‘.o’; nonsense results other¬ 
wise. 
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NAME 

lpq - spool queue examination program 

SYNOPSIS 

lpq [ +[ n ] ] [ -1 ] [ -Pprinter ] [ job # ... ] [ user ... ] 

DESCRIPTION 

lpq examines the spooling area used by lpd(S) for printing files on the line printer, and reports 
the status of the specified jobs or all jobs associated with a user, lpq invoked without any 
arguments reports on any jobs currently in the queue. A -P flag may be used to specify a 
particular printer, otherwise the default line printer is used (or the value of the PRINTER 
variable in the environment). If a + argument is supplied, lpq displays the spool queue until 
it empties. Supplying a number immediately after the + sign indicates that lpq should sleep 
n seconds in between scans of the queue. All other arguments supplied are interpreted as user 
names or job numbers to filter out only those jobs of interest. 

For each job submitted (i.e. invocation of /pr(l)) lpq reports the user’s name, current rank in 
the queue, the names of files comprising the job, the job identifier (a number which may be 
supplied to lprm( 1) for removing a specific job), and the total size in bytes. The -1 option 
causes information about each of the files comprising the job to be printed. Normally, only as 
much information as will fit on one line is displayed. Job ordering is dependent on the algo¬ 
rithm used to scan the spooling directory and is supposed to be FIFO (First in First Out). 
File names comprising a job may be unavailable (when lpr( 1) is used as a sink in a pipeline) in 
which case the file is indicated as “(standard input)". 

If lpq warns that there is no daemon present (i.e. due to some malfunction), the Ipc( 8) com¬ 
mand can be used to restart the printer daemon. 


FILES 

/etc/termcap 

/etc/printcap 

/usr/spool/* 

/usr/spool/*/cf* 
/usr/ spool/*/lock 


for manipulating the screen for 
repeated display 

to determine printer characteristics 

the spooling directory, as determined 

from printcap 

control files specifying jobs 

the lock file to obtain the currently 

active job 


SEE ALSO 

lpr(l), lprm(l), lpc(8), lpd(8) 


BUGS 

Due to the dynamic nature of the information in the spooling directory lpq may report unreli¬ 
ably. Output formatting is sensitive to the line length of the terminal; this can results in 
widely spaced columns. 

DIAGNOSTICS 

Unable to open various files. The lock file being malformed. Garbage files when there is no 
daemon active, but files in the spooling directory. 
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NAME 

lpr - off line print 

SYNOPSIS 

' pr [ —Vprinter ] [ -ffnum ] [ —C class ] [ — J job ] 

— T title ] [ — i [ numcols ]] [ —1234 font ] [ —w num ] 

— pltndgvcfrmhs ] [ name ... ] 

DESCRIPTION 

Lpr uses a spooling daemon to print the named files when facilities become available. If no 
names appear, the standard input is assumed. The -P option may be used to force output to 
a specific printer. Normally, the default printer is used (site dependent), or the value of the 
environment variable PRINTER is used. 

The following single letter options are used to notify the line printer spooler that the files are 
not standard text files. The spooling daemon will use the appropriate filters to print the data 
accordingly. 

—p Use pr(l) to format the files (equivalent to print). 

—1 Use a filter which allows control characters to be printed and suppresses page breaks. 

— t The files are assumed to contain data from troff[ 1) (cat phototypesetter commands). 

—n The files are assumed to contain data from ditroff (device independent troff). 

— d The files are assumed to contain data from tex{ 1) (DVI format from Stanford). 

—g The files are assumed to contain standard plot data as produced by the p/of(3X) rou¬ 
tines (see also plot( 1G) for the filters used by the printer spooler). 

—v The files are assumed to contain a raster image for devices like the Benson Varian. 

-c The files are assumed to contain data produced by cifplot( 1). 

—f Use a filter which interprets the first character of each line as a standard FORTRAN 

carriage control character. 

The remaining single letter options have the following meaning. 

-r Remove the file upon completion of spooling or upon completion of printing (with the -s 
option). 

-m Send mail upon completion. 

— h Suppress the printing of the burst page. 

-s Use symbolic links. Usually files are copied to the spool directory. 

The —C option takes the following argument as a job classification for use on the burst page. 
For example, 

lpr -C EECS foo.c 

causes the system name (the name returned by hostname( 1)) to be replaced on the burst page 
by EECS, and the file foo.c to be printed. 

The —J option takes the following argument as the job name to print on the burst page. 
Normally, the first file’s name is used. 

The — T option uses the next argument as the title used by pr(l) instead of the file name. 
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To get multiple copies of output, use the -#num option, where num is the number of copies 
desired of each file named. For example, 

lpr -#3 foo.c bar.c more.c 

would result in 3 copies of the file foo.c, followed by 3 copies of the file bar.c, etc. On the 
other hand, 

cat foo.c bar.c more.c | lpr -#3 
will give three copies of the concatenation of the files. 

The —i option causes the output to be indented. If the next argument is numeric, it is used as 
the number of blanks to be printed before each line; otherwise, 8 characters are printed. 

The -w option takes the immediately following number to be the page width for pr. 

The —s option will use symlink(2) to link data files rather than trying to copy them so large 
files can be printed. This means the files should not be modified or removed until they have 
been printed. 

The option —1234 Specifies a font to be mounted on font position i. The daemon will con¬ 
struct a .railmag file referencing /usr/lib/vfont/name.size. 


FILES 

/etc/passwd 

/etc/printcap 

/usr/lib/lpd* 

/usr/spool/* 

/usr/spool/*/cf* 

/usr/spool/*/df* 

/usr/spool/*/tf* 


personal identification 
printer capabilities data base 
line printer daemons 
directories used for spooling 
daemon control files 
data files specified in "cf" files 
temporary copies of "cf" files 


SEE ALSO 

lpq(l), lprm(l), pr(l), symlink(2), printcap(5), lpc(8), lpd(8), cleanlpd(8) 

DIAGNOSTICS 

If you try to spool too large a file, it will be truncated. Lpr will object to printing binary files. 
If a user other than root prints a file and spooling is disabled, lpr will print a message saying 
so and will not put jobs in the queue. If a connection to Ipd on the local machine cannot be 
made, lpr will say that the daemon cannot be started. Diagnostics may be printed in the 
daemon’s log file regarding missing spool files by Ipd. If Ipd is not configured properly or has 
become out of sync with it’s lock files, cleanlpd(8) may be used to restart Ipd in a new 
environment. 


BUGS 

Fonts for troff and tex reside on the host with the printer. It is currently not possible to use 
local font libraries. 
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NAME 

lprm - remove jobs from the line printer spooling queue 

SYNOPSIS 

lprm [ —P printer ] [ - ] [ job # ... ] [ user ... ] 

DESCRIPTION 

Lprm will remove a job, or jobs, from a printer’s spool queue. Since the spooling directory is 
protected from users, using lprm is normally the only method by which a user may remove a 
job. 

Lprm without any arguments will delete the currently active job if it is owned by the user 
who invoked lprm. 

If the — flag is specified, lprm will remove all jobs which a user owns. If the super-user 
employs this flag, the spool queue will be emptied entirely. The owner is determined by the 
user’s login name and host name on the machine where the Ipr command was invoked. 

Specifying a user’s name, or list of user names, will cause lprm to attempt to remove any jobs 
queued belonging to that user (or users). This form of invoking lprm is useful only to the 
super-user. 

A user may dequeue an individual job by specifying its job number. This number may be 
obtained from the lpq{ 1) program, e.g. 

% lpq -1 

1st: ken [job #013ucbarpa] 

(standard input) 100 bytes 

% lprm 13 

Lprm will announce the names of any files it removes and is silent if there are no jobs in the 
queue which match the request list. 

Lprm will kill off an active daemon, if necessary, before removing any spooling files. If a dae¬ 
mon is killed, a new one is automatically restarted upon completion of file removals. 

The —P option may be usd to specify the queue associated with a specific printer (otherwise 
the default printer, or the value of the PRINTER variable in the environment is used). 


FILES 

/etc/printcap printer characteristics file 

/usr/spool/* spooling directories 

/usr/spool/*/1 oc k lock file used to obtain the pid of the 
current daemon and the job number of 
the currently active job 


SEE ALSO 

lpr(l), lpq(l), lpd(8) 

DIAGNOSTICS 

“Permission denied" if the user tries to remove files other than his own. 

BUGS 

Since there are race conditions possible in the update of the lock file, the currently active job 
may be incorrectly identified. 
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NAME 

Is - list contents of directory 

SYNOPSIS 

1b [ -acdfgilqrstulACLFR ] name ... 

DESCRIPTION 

For each directory argument, Is lists the contents of the directory; for each file argument, Is 
repeats its name and any other information requested. By default, the output is sorted alpha¬ 
betically. When no argument is given, the current directory is listed. When several argu¬ 
ments are given, the arguments are first sorted appropriately, but file arguments are processed 
before directories and their contents. 

There are a large number of options: 

-1 List in long format, giving mode, number of links, owner, size in bytes, and time of 
last modification for each file. (See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. If the file is a symbolic link the 
pathname of the linked-to file is printed preceded by 

-g Include the group ownership of the file in a long output. 

—t Sort by time modified (latest first) instead of by name. 

—a List all entries; in the absence of this option, entries whose names begin with a period 

(.) are not listed. 

-8 Give size in kilobytes of each file. 

—d If argument is a directory, list only its name; often used with -1 to get the status of a 

directory. 

—L If argument is a symbolic link, list the file or directory the link references rather than 

the link itself. 

—r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

—u Use time of last access instead of last modification for sorting (with the —t option) 

and/or printing (with the -1 option). 

—c Use time of file creation for sorting or printing. 

—i For each file, print the i-number in the first column of the report. 

— f Force each argument to be interpreted as a directory and list the name found in each 

slot. This option turns off -1, -t, -s, and -r, and turns on —a; the order is the order 
in which entries appear in the directory. 

-F cause directories to be marked with a trailing */*, sockets with a trailing '=’, symbolic 
links with a trailing and executable files with a trailing V. 

-R recursively list subdirectories encountered. 

-1 force one entry per line output format; this is the default when output is not to a ter¬ 
minal. 

-C force multi-column output; this is the default when output is to a terminal. 

—q force printing of non-graphic characters in file names as the character '?’; this is the 

default when output is to a terminal. 
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The mode printed under the -1 option contains 11 characters which are interpreted as follows: 
the first character is 

d if the entry is a directory; 
b if the entry is a block-type special file; 
c if the entry is a character-type special file; 

1 if the entry is a symbolic link; 
s if the entry is a socket, or 

— if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions; the next to permissions to others in the same user-group; and the last to 
all others. Within each set the three characters indicate permission respectively to read, to 
write, or to execute the file as a program. For a directory, ‘execute’ permission is interpreted 
to mean permission to search the directory. The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 
x if the file is executable; 

— if the indicated permission is not granted. 

The group-execute permission character is given as s if the file has the set-group-id bit set; 
likewise the user-execute permission character is given as s if the file has the set-user-id bit 
set. 

The last character of the mode (normally ‘x’ or is t if the 1000 bit of the mode is on. See 
chmod(l) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect 
blocks is printed. 


FILES 

/etc/passwd to get user id’s for ‘Is -1’. 
/etc/group to get group id’s for ‘Is -g’. 


BUGS 

Newline and tab are considered printing characters in file names. 

The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype is undesirable as “Is -s” is much 
different than “Is -s | lpr”. On the other hand, not doing this setting would make old shell 
scripts which used Is almost certain losers. 
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NAME 

lxref - lisp cross reference program 
SYNOPSIS 

lxref [ -N ] xref-file ... [ -a source-file ... ] 

DESCRIPTION 

Lxref reads cross reference file(s) written by the lisp compiler liszt and prints a cross reference 
listing on the standard output. Liszt will create a cross reference file during compilation when 
it is given the —x switch. Cross reference files usually end in ‘.x’ and consequently lxref will 
append a ‘.x’ to the file names given if necessary. The first option to lxref is a decimal integer, 
N, which sets the ignorelevel. If a function is called more than ignorelevel times, the cross 
reference listing will just print the number of calls instead of listing each one of them. The 
default for ignorelevel is 50. 

The —a option causes lxref to put limited cross reference information in the sources named. 
lxref will scan the source and when it comes across a definition of a function (that is a line 
beginning with ‘(def ’ it will preceed that line with a list of the functions which call this func¬ 
tion, written as a comment preceeded by ’ . All existing lines beginning with ’will be 
removed from the file. If the source file contains a line beginning ‘/-’then this will disable 
this annotation process from this point on until a ’ is seen (however, lines beginning with 
’ will continue to be deleted). After the annoation is done, the original file foo.l’ is 
renamed to " ‘jf.foo.l*' and the new file with annotation is named foo.l’ 

AUTHOR 

John Foderaro 

SEE ALSO 

lisp(l), liszt(l) 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ files ] 


DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of 
the argument files is processed in order; if there are no arguments, or if an argument is the 
standard input is read. The processed text is written on the standard output. 

Macro calls have the form 

name(argl,arg2, .... argn) 

The ‘(’ must immediately follow the name of the macro. If a defined macro name is not fol¬ 
lowed by a it is deemed to have no arguments. Leading unquoted blanks, tabs, and new¬ 
lines are ignored while collecting arguments. Potential macro names consist of alphabetic 
letters, digits, and underscore where the first character is not a digit. 

Left and right single quotes (' ') are used to quote strings. The value of a quoted string is the 
string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching 
right parenthesis. Macro evaluation proceeds normally during the collection of the arguments, 
and any commas or right parentheses which happen to turn up within the value of a nested 
call are as effective as those in the original input text. After argument collection, the value of 
the macro is pushed back onto the input stream and rescanned. 

C M/ makes available the following built-in macros. They may be redefined, but once this is 
done the original meaning is lost. Their values are null unless otherwise stated. 

define The second argument is installed as the value of the macro whose name is the first 
argument. Each occurrence of $n in the replacement text, where n is a digit, is 
replaced by the n-th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string. 

undefine removes the definition of the macro named in its argument. 

ifdef If the first argument is defined, the value is the second argument, otherwise the 
third. If there is no third argument, the value is null. The word unix is 
predefined on UNIX versions of m4- 

changequote 

Change quote characters to the first and second arguments. Changequote without 
arguments restores the original values (i.e., ' '). 

divert M4 maintains 10 output streams, numbered 0-9. The final output is the concate¬ 
nation of the streams in numerical order; initially stream 0 is the current stream. 
The divert macro changes the current output stream to its (digit-string) argument. 
Output diverted to a stream other than 0 through 9 is discarded. 

undivert causes immediate output of text from diversions named as arguments, or all 
diversions if no argument. Text may be undiverted into another diversion. 
Undiverting discards the diverted text. 

divnum returns the value of the current output stream. 

dnl reads and discards characters up to and including the next newline. 

c 
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if else 


incr 

eval 

len 

index 

substr 


translit 

include 

sinclude 

syscmd 


has three or more arguments. If the first argument is the same string as the 
second, then the value is the third argument. If not, and if there are more than 
four arguments, the process is repeated with arguments 4, 5, 6 and 7. Otherwise, 
the value is either the fourth string, or, if it is not present, null. 

returns the value of its argument incremented by 1. The value of the argument is 
calculated by interpreting an initial digit-string as a decimal number. 

evaluates its argument as an arithmetic expression, using 32-bit arithmetic. 
Operators include -f, -, *, /, %, ' (exponentiation); relationals; parentheses. 

returns the number of characters in its argument. 

returns the position in its first argument where the second argument begins (zero 
origin), or -1 if the second argument does not occur. 

returns a substring of its first argument. The second argument is a zero origin 
number selecting the first character; the third argument indicates the length of the 
substring. A missing third argument is taken to be large enough to extend to the 
end of the first string. 

transliterates the characters in its first argument from the set given by the second 
argument to the set given by the third. No abbreviations are permitted. 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is inaccessible. 

executes the UNIX command given in the first argument. No value is returned. 


maketemp 

fills in a string of XXXXX in its argument with the current process id. 
errprint prints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the named items, or for all if no argu¬ 
ments are given. 



SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The Macro Processor 
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NAME 

mail - send and receive mail 


SYNOPSIS 

mail 

—V 

• 

—1 

-n 

[ —s subject ] 

mail 

-V 

-i 

—n 

-f [ name ] 

mail 

—V 

• 1 
—l 

—n 

—u user 


user ... ] 


INTRODUCTION 

Mail is a intelligent mail processing system, which has a command syntax reminiscent of ed 
with lines replaced by messages. 

The —v flag puts mail into verbose mode; the details of delivery are displayed on the users ter¬ 
minal. The —i flag causes tty interrupt signals to be ignored. This is particularly useful when 
using mail on noisy phone lines. The -n flag inhibits the reading of /usr/lib/Mail.rc. 

Sending mail. To send a message to one or more other people, mail can be invoked with argu¬ 
ments which are the names of people to send to. You are then expected to type in your mes¬ 
sage, followed by an EOT (control-D) at the beginning of a line. A subject may be specified on 
the command line by using the — s flag. (Only the first argument after the — s flag is used as a 
subject; be careful to quote subjects containing spaces.) The section below, labeled Replying to 
or originating mail, describes some features of mail available to help you compose your letter. 

Reading mail. In normal usage mail is given no arguments and checks your mail out of the 
post office, then prints out a one line header of each message there. The current message is 
initially the first message (numbered 1) and can be printed using the print command (which 
can be abbreviated p). You can move among the messages much as you move between lines 
in ed, with the commands ‘+’ and moving backwards and forwards, and simple numbers. 

Disposing of mail. After examining a message you can delete (d) the message or reply (r) to 
it. Deletion causes the mail program to forget about the message. This is not irreversible; the 
message can be undeleted (u) by giving its number, or the mail session can be aborted by 
giving the exit (x) command. Deleted messages will, however, usually disappear never to be 
seen again. 

Specifying messages. Commands such as print and delete can be given a list of message 
numbers as arguments to apply to a number of messages at once. Thus “delete 1 2” deletes 
messages 1 and 2, while “delete 1-5” deletes messages 1 through 5. The special name 
addresses all messages, and “$” addresses the last message; thus the command top which 
prints the first few lines of a message could be used in “top *” to print the first few lines of all 
messages. 

Replying to or originating mail. You can use the reply command to set up a response to a 
message, sending it back to the person who it was from. Text you then type in, up to an 
end-of-file, defines the contents of the message. While you are composing a message, mail 
treats lines beginning with the character specially. For instance, typing “~m” (alone on a 
line) will place a copy of the current message into the response right shifting it by a tabstop. 
Other escapes will set up subject fields, add and delete recipients to the message and allow 
you to escape to an editor to revise the message or to a shell to run some commands. (These 
options are given in the summary below.) 

Ending a mail processing session. You can end a mail session with the quit (q) command. 
Messages which have been examined go to your mbox file unless they have been deleted in 
which case they are discarded. Unexamined messages go back to the post office. The —f 
option causes mail to read in the contents of your mbox (or the specified file) for processing; 
when you quit, mail writes undeleted messages back to this file. The — u flag is a short way 
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of doing "mail -f /usr/spool/mail/user". 

Personal and systemtvide distribution lists. It is also possible to create a personal distribution 
lists so that, for instance, you can send mail to “cohorts” and have it go to a group of people. 
Such lists can be defined by placing a line like 

alias cohorts bill ozalp jkf mark kridle@ucbcory 

in the file .mailrc in your home directory. The current list of such aliases can be displayed 
with the alias (a) command in mail. System wide distribution lists can be created by editing 
/usr/lib/aliases, see aliases(5) and sendmail ($); these are kept in a different syntax. In mail 
you send, personal aliases will be expanded in mail sent to others so that they will be able to 
reply to the recipients. System wide aliases are not expanded when the mail is sent, but any 
reply returned to the machine will have the system wide alias expanded as all mail goes 
through sendmail. 

Network mail (ARPA, UUCP, Berknet) See mailaddr(7) for a description of network 
addresses. 

Mail has a number of options which can be set in the .mailrc file to alter its behavior; thus 
“set askcc” enables the “askcc” feature. (These options are summarized below.) 

SUMMARY 

(Adapted from the ‘Mail Reference Manual’) 

Each command is typed on a line by itself, and may take arguments following the command 
word. The command need not be typed in its entirety - the first command which matches 
the typed prefix is used. For commands which take message lists as arguments, if no message 
list is given, then the next message forward which satisfies the command’s requirements is 
used. If there are no messages forward of the current message, the search proceeds back¬ 
wards, and if there are no good messages at all, mail types “No applicable messages” and 
aborts the command. 

Goes to the previous message and prints it out. If given a numeric argument n, 
goes to the n-th previous message and prints it. 

Prints a brief summary of commands. 

Executes the UNIX shell command which follows. 

(P) Like print but also prints out ignored header fields. See also print and 
ignore. 

(R) Reply to originator. Does not reply to other recipients of the original mes¬ 
sage. 

(T) Identical to the Print command. 

(a) With no arguments, prints out all currently-defined aliases. With one argu¬ 
ment, prints out that alias. With more than one argument, creates an new or 
changes an on old alias. 

alternates (alt) The alternates command is useful if you have accounts on several 
machines. It can be used to inform mail that the listed addresses are really you. 
When you reply to messages, mail will not send a copy of the message to any of 
the addresses listed on the alternates list. If the alternates command is given 
with no argument, the current set of alternate names is displayed. 

chdir (c) Changes the user’s working directory to that specified, if given. If no direc¬ 

tory is given, then changes to the user’s login directory. 


? 

! 

Print 

Reply 

Type 

alias 
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copy 

delete 


dp 

edit 

exit 

file 

folders 

folder 


from 

headers 


help 

hold 


ignore 


mail 

mbox 


next 

preserve 

print 

quit 


(co) The copy command does the same thing that save does, except that it 
does not mark the messages it is used on for deletion when you quit. 

(d) Takes a list of messages as argument and marks them all as deleted. 
Deleted messages will not be saved in mbox, nor will they be available for most 
other commands. 

(also dt) Deletes the current message and prints the next message. If there is no 
next message, mail says “at EOF.” 

(e) Takes a list of messages and points the text editor at each one in turn. On 
return from the editor, the message is read back in. 

(ex or x) Effects an immediate return to the Shell without modifying the user’s 
system mailbox, his mbox file, or his edit file in —f. 

(fi) The same as folder. 

List the names of the folders in your folder directory. 

(fo) The folder command switches to a new mail file or folder. With no argu¬ 
ments, it tells you which file you are currently reading. If you give it an argu¬ 
ment, it will write out changes (such as deletions) you have made in the current 
file and read in the new file. Some special conventions are recognized for the 
name. # means the previous file, % means your system mailbox, %user means 
user’s system mailbox, & means your '/mbox file, and -ffolder means a file in 
your folder directory. 

(f) Takes a list of messages and prints their message headers. 

(h) Lists the current range of headers, which is an 18 message group. If a “+” 
argument is given, then the next 18 message group is printed, and if a argu¬ 
ment is given, the previous 18 message group is printed. 

A synonym for ? 

(ho, also preserve) Takes a message list and marks each message therein to be 
saved in the user’s system mailbox instead of in mbox. Does not override the 
delete command. 

Add the list of header fields named to the ignored list. Header fields in the 
ignore list are not printed on your terminal when you print a message. This 
command is very handy for suppression of certain machine-generated header 
fields. The Type and Print commands can be used to print a message in its 
entirety, including ignored fields. If ignore is executed with no arguments, it 
lists the current set of ignored fields. 

(m) Takes as argument login names and distribution group names and sends 
mail to those people. 

Indicate that a list of messages be sent to mbox in your home directory when 
you quit. This is the default action for messages if you do not have the hold 
option set. 

(n like -|- or CR) Goes to the next message in sequence and types it. With an 
argument list, types the next matching message. 

(pre) A synonym for hold. 

(p) Takes a message list and types out each message on the user’s terminal. 

(q) Terminates the session, saving all undeleted, unsaved messages in the user’s 
mbox file in his login directory, preserving all messages marked with hold or 
preserve or never referenced in his system mailbox, and removing all other 
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reply 

respond 

save 


set 

shell 

size 

source 

top 

type 

unalias 

undelete 

unset 


messages from his system mailbox. If new mail has arrived during the session, 
the message “You have new mail” is given. If given while editing a mailbox file 
with the -f flag, then the edit file is rewritten. A return to the Shell is effected, 
unless the rewrite of edit file fails, in which case the user can escape with the 
exit command. 

(r) Takes a message list and sends mail to the sender and all recipients of the 
specified message. The default message must not be deleted. 

A synonym for reply. 

(s) Takes a message list and a filename and appends each message in turn to the 
end of the file. The filename in quotes, followed by the line count and character 
count is echoed on the user’s terminal. 

(se) With no arguments, prints all variable values. Otherwise, sets option. 
Arguments are of the form “option=value” or “option.” 

(sh) Invokes an interactive version of the shell. 

Takes a message list and prints out the size in characters of each message. 

(so) The source command reads mail commands from a file. 

Takes a message list and prints the top few lines of each. The number of lines 
printed is controlled by the variable toplines and defaults to five. 

(t) A synonym for print. 

Takes a list of names defined by alias commands and discards the remembered 
groups of users. The group names no longer have any significance. 

(u) Takes a message list and marks each one as not being deleted. 

Takes a list of option names and discards their remembered values; the inverse 
of set. 


visual 

write 

xit 

z 


(v) Takes a message list and invokes the display editor on each message. 

(w) A synonym for save. 

(x) A synonym for exit. 

Mail presents message headers in windowfuls as described under the headers 
command. You can move mail’s attention forward to the next window with the 
z command. Also, you can move to the previous window by using z—. 


Here is a summary of the tilde escapes, which are used when composing messages to perform 
special functions. Tilde escapes are only recognized at the beginning of lines. The name 
“tilde escape” is somewhat of a misnomer since the actual escape character can be set by the 
option escape. 


~ Icommand 
~c name ... 

~d 

~e 

”f messages 

~h 


Execute the indicated shell command, then return to the message. 

Add the given names to the list of carbon copy recipients. 

Read the file “dead.letter” from your home directory into the message. 

Invoke the text editor on the message collected so far. After the editing session 
is finished, you may continue appending text to the message. 

Read the named messages into the message being sent. If no messages are 
specified, read in the current message. 

Edit the message header fields by typing each one in turn and allowing the user 
to append text to the end or modify the field by using the current terminal erase 
and kill characters. 





^_y 
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~m messages Read the named messages into the message being sent, shifted right one tab. If 
no messages are specified, read the current message. 

~p Print out the message collected so far, prefaced by the message header fields. 

~q Abort the message being sent, copying the message to “dead.letter” in your 

home directory if save is set. 

~r filename Read the named file into the message. 

~s string Cause the named string to become the current subject field. 

~t name ... Add the given names to the direct recipient list. 

~v Invoke an alternate editor (defined by the VISUAL option) on the message col¬ 

lected so far. Usually, the alternate editor will be a screen editor. After you 
quit the editor, you may resume appending text to the end of your message. 

'■w filename Write the message onto the named file. 

~ |command Pipe the message through the command as a filter. If the command gives no 
output or terminates abnormally, retain the original text of the message. The 
command fmt( 1) is often used as command to rejustify the message. 

"string Insert the string of text in the message prefaced by a single “. If you have 
changed the escape character, then you should double that character in order to 
send it. 

Options are controlled via the set and unset commands. Options may be either binary, in 
which case it is only significant to see whether they are set or not, or string, in which case the 
actual value is of interest. The binary options include the following: 

append Causes messages saved in mbox to be appended to the end rather than 

prepended. (This is set in /usr/lib/Mail.rc on version 7 systems.) 

ask Causes mail to prompt you for the subject of each message you send. If you 

respond with simply a newline, no subject field will be sent. 

askcc Causes you to be prompted for additional carbon copy recipients at the end 

of each message. Responding with a newline indicates your satisfaction with 
the current list. 

Causes the delete command to behave like dp - thus, after deleting a mes¬ 
sage, the next one will be typed automatically. 

Setting the binary option debug is the same as specifying —d on the com¬ 
mand line and causes mail to output all sorts of information useful for 
debugging mail. 

The binary option dot causes mail to interpret a period alone on a line as the 
terminator of a message you are sending. 

This option is used to hold messages in the system mailbox by default. 

Causes interrupt signals from your terminal to be ignored and echoed as 
@’s. 

An option related to dot is ignoreeof which makes mail refuse to accept a 
control-d as the end of a message. Ignoreeof also applies to mail command 
mode. 

metoo Usually, when a group is expanded that contains the sender, the sender is 

removed from the expansion. Setting this option causes the sender to be 
included in the group. 


autopnnt 

debug 

dot 

hold 

ignore 

ignoreeof 
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nosave Normally, when you abort a message with two RUBOUT, mail copies the par- 

tial letter to the file “dead.letter” in your home directory. Setting the binary V y 
option nosave prevents this. 

quiet Suppresses the printing of the version when first invoked. 

verbose Setting the option verbose is the same as using the -v flag on the command 

line. When mail runs in verbose mode, the actual delivery of messages is 
displayed on he users terminal. 

The following options have string values: 

EDITOR Pathname of the text editor to use in the edit command and ~e escape. If 

not defined, then a default editor is used. 

SHELL Pathname of the shell to use in the ! command and the “! escape. A default 

shell is used if this option is not defined. 

VISUAL Pathname of the text editor to use in the visual command and ~v escape. 

crt The valued option crt is used as a threshold to determine how long a mes¬ 

sage must be before more is used to read it. 

escape If defined, the first character of this option gives the character to use in the 

place of ~ to denote escapes. 

folder The name of the directory to use for storing folders of messages. If this name 

begins with a ‘/’, mail considers it to be an absolute pathname; otherwise, 
the folder directory is found relative to your home directory. 

record If defined, gives the pathname of the file used to record all outgoing mail. If 

not defined, then outgoing mail is not so saved. 

toplines If defined, gives the number of lines of a message to be printed out with the 

top command; normally, the first five lines are printed. v ^ 

FILES 

/usr/spool/m ail/* 

~/mbox 
'/.mailrc 
/tmp/R# 

/usr/lib/Mail.help* 

/usr/lib/Mail.rc 
Message* 

SEE ALSO 

binmail(l), fmt(l), newaliases(l), aliases(5), 
mailaddr(7), sendmail(8) 

‘The Mail Reference Manual’ 


post office 
your old mail 

file giving initial mail commands 
temporary for editor escape 
help files 

system initialization file 
temporary for editing messages 


BUGS 

There are many flags that are not documented here. Most are not useful to the general user. 
Usually, mail is just a link to Mail, which can be confusing. 


AUTHOR 

Kurt Shoens 
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NAME 

make - maintain program groups 
SYNOPSIS 

make [ -f makefile ] [ option ] ... file... 

DESCRIPTION 

Make executes commands in makefile to update one or more target names. Name is typically 
a program. If no -f option is present, ‘makefile’ and ‘Makefile’ are tried in order. If makefile 
is the standard input is taken. More than one -f option may appear 

Make updates a target if it depends on prerequisite files that have been modified since the tar¬ 
get was last modified, or if the target does not exist. 

Makefile contains a sequence of entries that specify dependencies. The first line of an entry is 
a blank-separated list of targets, then a colon, then a list of prerequisite files. Text following 
a semicolon, and all following lines that begin with a tab, are shell commands to be executed 
to update the target. If a name appears on the left of more than one ‘colon’ line, then it 
depends on all of the names on the right of the colon on those lines, but only one command 
sequence may be specified for it. If a name appears on a line with a double colon :: then the 
command sequence following that line is performed only if the name is out of date with 
respect to the names to the right of the double colon, and is not affected by other double 
colon lines on which that name may appear. 

Two special forms of a name are recognized. A name like a(b) means the file named 6 stored 
in the archive named a. A name like a((6)) means the file stored in archive a containing the 
entry point b. 

Sharp and newline surround comments. 

The following makefile says that ‘pgm’ depends on two files ‘a.o’ and ‘b.o’, and that they in 
turn depend on ‘.c’ files and a common file ‘incl’. 

pgm: a.o b.o 

cc a.o b.o -lm -o pgm 

a. o: incl a.c 

cc -c a.c 

b. o: incl b.c 

cc -c b.c 

Makefile entries of the form 
stringl = string2 

are macro definitions. Subsequent appearances of $(stringl) or %{stringl } are replaced by 
strings. If stringl is a single character, the parentheses or braces are optional. 

Make infers prerequisites for files for which makefile gives no construction commands. For 
example, a ‘.c’ file may be inferred as prerequisite for a ‘.o’ file and be compiled to produce the 
‘.o’ file. Thus the preceding example can be done more briefly: 

pgm: a.o b.o 

cc a.o b.o -lm -o pgm 
a.o b.o: incl 

Prerequisites are inferred according to selected suffixes listed as the ‘prerequisites’ for the spe¬ 
cial name ‘.SUFFIXES’; multiple lists accumulate; an empty list clears what came before. 
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Order is significant; the first possible name for which both a file and a rule as described in the 
next paragraph exist is inferred. The default list is 

.SUFFIXES: .out .o .c .e .r .f .y .1 .s .p 

The rule to create a file with suffix s2 that depends on a similarly named file with suffix si is 
specified as an entry for the ‘target’ sls2. In such an entry, the special macro $* stands for 
the target name with suffix deleted, $@ for the full target name, $< for the complete list of 
prerequisites, and $? for the list of prerequisites that are out of date. For example, a rule for 
making optimized ‘.o’ files from ‘.c’ files is 

.c.o: ; cc -c -O -o $@ $*.c 

Certain macros are used by the default inference rules to communicate optional arguments to 
any resulting compilations. In particular, ‘CFLAGS’ is used for cc(l) options, ‘FFLAGS’ for 
/77(1) options, ‘PFLAGS’ for pc(l) options, and ‘LFLAGS’ and ‘YFLAGS’ for lex and yace(l) 
options. In addition, the macro ‘MFLAGS’ is filled in with the initial command line options 
supplied to make. This simplifies maintaining a hierarchy of makefiles as one may then 
invoke make on makefiles in subdirectories and pass along useful options such as -k. 

Command lines are executed one at a time, each by its own shell. A line is printed when it is 
executed unless the special target ‘.SILENT’ is in makefile, or the first character of the com¬ 
mand is 

Commands returning nonzero status (see m<ro(l)) cause make to terminate unless the special 
target ‘.IGNORE’ is in makefile or the command begins with <tab> <hyphen >. 

Interrupt and quit cause the target to be deleted unless the target is a directory or depends on 
the special name ‘.PRECIOUS’. 

Other options: 

—i Equivalent to the special entry ‘.IGNORE:’. 

-k When a command returns nonzero status, abandon work on the current entry, but 
continue on branches that do not depend on the current entry. 

—n Trace and print, but do not execute the commands needed to update the targets. 

—t Touch, i.e. update the modified date of targets, without executing any commands. 

-r Equivalent to an initial special entry ‘.SUFFIXES:’ with no list. 

-s Equivalent to the special entry ‘.SILENT:’. 

FILES 

makefile, Makefile 

SEE ALSO 

sh(l), touch(l), f77(l), pc(l) 

S. I. Feldman Make - A Program for Maintaining Computer Programs 


BUGS 

Some commands return nonzero status inappropriately. Use -i to overcome the difficulty. 
Commands that are directly executed by the shell, notably cd(l), are ineffectual across new¬ 
lines in make. 
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NAME 

man - find manual information by keywords; print out the manual 

SYNOPSIS 

man — k keyword ... 
man -f file ... 

man [ - ] { —t ] [ section ] title ... 

DESCRIPTION 

Man is a program which gives information from the programmers manual. It can be asked for 
one line descriptions of commands specified by name, or for all commands whose description 
contains any of a set of keywords. It can also provide on-line access to the sections of the 
printed manual. 

When given the option -k and a set of keywords, man prints out a one line synopsis of each 
manual sections whose listing in the table of contents contains that keyword. 

When given the option —f and a list of file names, man attempts to locate manual sections 
related to those files, printing out the table of contents lines for those sections. 

When neither —k nor -f is specified, man formats a specified set of manual pages. If a section 
specifier is given man looks in the that section of the manual for the given titles. Section is an 
Arabic section number (3 for instance). The number may followed by a single letter classifier 
(lg for instance) indicating a graphics program in section 1. If section is omitted, man 
searches all sections of the manual, giving preference to commands over subroutines in system 
libraries, and printing the first section it finds, if any. 

If the standard output is a teletype, or if the flag - is given, man pipes its output through 
ca£(l) with the option -s to crush out useless blank lines, u/(l) to create proper underlines for 
different terminals, and through more(l) to stop after each page on the screen. Hit a space to 
continue, a control-D to scroll 11 more lines w'hen the output stops. 

The —t flag causes man to arrange for the specified section to be troff’ed. to a suitable raster 
output device; see vtroff( 1). 


FILES 

/usr/man/man?/* 

/usr/man/cat?/* 

SEE ALSO 

more(l), ul(l), whereis(l), catman(8) 


BUGS 

The manual is supposed to be reproducible either on the phototypesetter or on a typewriter. 
However, on a typewriter some information is necessarily lost. 


ICON INTERNATIONAL 


1 



MERGE(1) 


USER COMMANDS 


MERGE(1) 


NAME 

merge - three-way file merge 
SYNOPSIS 

merge [ -p ] filel file2 file3 
DESCRIPTION 

Merge incorporates all changes that lead from file2 to fileS into filel. The result goes to std. 
output if -p is present, into filel otherwise. Merge is useful for combining separate changes to 
an original. Suppose fileS is the original, and both filel and fileS are modifications of fileS. 
Then merge combines both changes. 

An overlap occurs if both filel and fileS have changes in a common segment of lines. Merge 
prints how many overlaps occurred, and includes both alternatives in the result. The alterna¬ 
tives are delimited as follows: 

<<<<<<< filel 
lines in filel 


lines in file3 
>>>>>>> file3 

If there are overlaps, the user should edit the result and delete one of the alternatives. 
IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 3.0 ; Release Date: 82/11/25 . 

Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

diff3 (1), diff (1), rcsmerge (1), co (1). 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION 

Mesg with argument n forbids messages via write and talk( 1) by revoking non-user write per¬ 
mission on the user’s terminal. Mesg with argument y reinstates permission. All by itself, 
mesg reports the current state without changing it. 


FILES 

/dev/tty* 

SEE ALSO 

write(l), talk(l) 


DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 


ICON INTERNATIONAL 


1 



MKDIR(l) 


USER COMMANDS 


MKDIR(l) 


NAME 

mkdir - make a directory 

SYNOPSIS 

mkdir dirname ... 



DESCRIPTION 

Mkdir creates specified directories in mode 777. Standard entries, V, for the directory itself, 
and for its parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rmdir(l) 


zf . 

( ' 
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NAME 

mkstr - create an error message file by massaging C source 

SYNOPSIS 

mkstr [ — ] messagefile prefix file ... 

DESCRIPTION 

Mkstr is used to create files of error messages. Its use can make programs with large numbers 
of error diagnostics much smaller, and reduce system overhead in running the program as the 
error messages do not have to be constantly swapped in and out. 

Mkstr will process each of the specified files, placing a massaged version of the input file in a 
file whose name consists of the specified prefix and the original name. A typical usage of 
mkstr would be 

mkstr pistrings xx *.c 

This command would cause all the error messages from the C source files in the current direc¬ 
tory to be placed in the file pistrings and processed copies of the source for these files to be 
placed in files whose names are prefixed with xx. 

To process the error messages in the source to the message file mkstr keys on the string 
‘errorf’’ in the input stream. Each time it occurs, the C string starting at the £ "’ is placed in 
the message file followed by a null character and a new-line character; the null character ter¬ 
minates the message so it can be easily used when retrieved, the new-line character makes it 
possible to sensibly cat the error message file to see its contents. The massaged copy of the 
input file then contains a Iseek pointer into the file which can be used to retrieve the message, 
i.e.: 


char efilname[] = ”/usr/lib/pLstrings"; 
int efil = -1; 

error(al, a2, a3, a4) 

char buf[256]; 

if (efil < 0) { 

efil = open(efilname, 0); 
if (efil < 0) { 

oops: 

perror(efilname); 

exit(l); 

} 

} 

if (lseek(efil, (long) al, 0) 11 read(efil, buf, 256) <= 0) 
goto oops; 

printf(buf, a2, a3, a4); 

} 

The optional — causes the error messages to be placed at the end of the specified message file 
for recompiling part of a large mkstr e d program. 


ICON INTERNATIONAL 


1 



MKSTR (1) 


USER COMMANDS 


MKSTR (1) 


SEE ALSO 

lseek(2), xstr(l) 

AUTHORS 

William Joy and Charles Haley 
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NAME 

more, page - file perusal filter for crt viewing 

SYNOPSIS 

more [ -cdflsu ] [ -n ] [ +linenumber ] [ +/ pattern ] [ name ... ] 
page more options 

DESCRIPTION 

More is a filter which allows examination of a continuous text one screenful at a time on a 
soft-copy terminal. It normally pauses after each screenful, printing —More— at the bottom of 
the screen. If the user then types a carriage return, one more line is displayed. If the user 
hits a space, another screenful is displayed. Other possibilities are enumerated later. 

The command line options are: 

-n An integer which is the size (in lines) of the window which more will use instead of the 
default. 

—c More will draw each page by beginning at the top of the screen and erasing each line 
just before it draws on it. This avoids scrolling the screen, making it easier to read 
while more is writing. This option will be ignored if the terminal does not have the 
ability to clear to the end of a line. 

—d More will prompt the user with the message "Hit space to continue, Rubout to abort" 

at the end of each screenful. This is useful if more is being used as a filter in some set¬ 
ting, such as a class, where many users may be unsophisticated. 

—f This causes more to count logical, rather than screen lines. That is, long lines are not 
folded. This option is recommended if nroff output is being piped through ul, since 
the latter may generate escape sequences. These escape sequences contain characters 
which would ordinarily occupy screen positions, but which do not print when they are 
sent to the terminal as part of an escape sequence. Thus more may think that lines 
are longer than they actually are, and fold lines erroneously. 

—1 Do not treat "L (form feed) specially. If this option is not given, more will pause after 
any line that contains a "L, as if the end of a screenful had been reached. Also, if a 
file begins with a form feed, the screen will be cleared before the file is printed. 

-s Squeeze multiple blank lines from the output, producing only one blank line. Espe¬ 
cially helpful when viewing nroff output, this option maximizes the useful information 
present on the screen. 

—u Normally, more will handle underlining such as produced by nroff in a manner 

appropriate to the particular terminal: if the terminal can perform underlining or has 
a stand-out mode, more will output appropriate escape sequences to enable underlining 
or stand-out mode for underlined information in the source file. The -u option 
suppresses this processing. 

+linenumber 

Start up at linenumber. 

+/pattern 

Start up two lines before the line containing the regular expression pattern . 

If the program is invoked as page, then the screen is cleared before each screenful is printed 
(but only if a full screenful is being printed), and k - 1 rather than k - 2 lines are printed in 
each screenful, where k is the number of lines the terminal can display. 
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More looks in the file / etc/termcap to determine terminal characteristics, and to determine the 
default window size. On a terminal capable of displaying 24 lines, the default window size is 
22 lines. 

More looks in the environment variable MORE to pre-set any flags desired. For example, if 
you prefer to view files using the -c mode of operation, the csh command setenv MORE -c or 
the sh command sequence MORE-’-c’; export MORE would cause all invocations of more , 
including invocations by programs such as man and msgs , to use this mode. Normally, the 
user will place the command sequence which sets up the MORE environment variable in the 
.cshrc or .profile file. 

If more is reading from a file, rather than a pipe, then a percentage is displayed along with 
the —More- prompt. This gives the fraction of the file (in characters, not lines) that has been 
read so far. 

Other sequences which may be typed when more pauses, and their effects, are as follows (i is 
an optional integer argument, defaulting to 1) : 

i <space> 

display i more lines, (or another screenful if no argument is given) 

~D display 11 more lines (a “scroll”). If i is given, then the scroll size is set to i. 
d same as "D (control-D) 

»z same as typing a space except that i, if present, becomes the new window size, 

is skip i lines and print a screenful of lines 

if skip i screenfuls and print a screenful of lines 

q or Q Exit from more. 

— Display the current line number. 

v Start up the editor vi at the current line. 

h Help command; give a description of all the more commands. 

i/expr search for the i-th occurrence of the regular expression expr. If there are less than i 

occurrences of expr, and the input is a file (rather than a pipe), then the position in 

the file remains unchanged. Otherwise, a screenful is displayed, starting two lines 
before the place where the expression was found. The user’s erase and kill characters 
may be used to edit the regular expression. Erasing back past the first column cancels 
the search command. 

in search for the i-th occurrence of the last regular expression entered. 

’ (single quote) Go to the point from which the last search started. If no search has 

been performed in the current file, this command goes back to the beginning of the 
file. 

Icommand 

invoke a shell with command. The characters and '!’ in "command" are replaced 
with the current file name and the previous shell command respectively. If there is no 
current file name, *%’ is not expanded. The sequences "\%" and "\!" are replaced by 
"%" and "!" respectively. 

i:n skip to the i-th next file given in the command line (skips to last file if n doesn’t make 
sense) 
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*:p skip to the i-th previous file given in the command line. If this command is given in 
the middle of printing out a file, then more goes back to the beginning of the file. If i 
doesn’t make sense, more skips back to the first file. If more is not reading from a file, 
the bell is rung and nothing else happens. 

:f display the current file name and line number. 

:q or :Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to type a carriage return. Up 
to the time when the command character itself is given, the user may hit the line kill charac¬ 
ter to cancel the numerical argument being formed. In addition, the user may hit the erase 
character to redisplay the --More—(xx%) message. 

At any time when output is being sent to the terminal, the user can hit the quit key (nor¬ 
mally control-\). More will stop sending output, and will display the usual —More— prompt. 
The user may then enter one of the above commands in the normal manner. Unfortunately, 
some output is lost when this is done, due to the fact that any characters waiting in the 
terminal’s output queue are flushed when the quit signal occurs. 

The terminal is set to noecho mode by this program so that the output can be continuous. 
What you type will thus not show on your terminal, except for the / and ! commands. 

If the standard output is not a teletype, then more acts just like cat, except that a header is 
printed before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 
nroff -ms +2 doc.n | more -s 


AUTHOR 

Eric Shienbrood, minor revisions by John Foderaro and Geoffrey Peck 


FILES 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 


SEE ALSO 

csh(l), man(l), msgs(l), script(l), sh(l), environ(7) 
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NAME 

msgs - system messages and junk mail program 
SYNOPSIS 

msgs [ — fhlpq ] [ number ] ( -number ] 

DESCRIPTION 

Msgs is used to read system messages. These messages are sent by mailing to the login ‘msgs’ 
and should be short pieces of information which are suitable to be read once by most users of 
the system. 

Msgs is normally invoked each time you login, by placing it in the file .login (.profile if you use 
/ bin/sh ). It will then prompt you with the source and subject of each new message. If there 
is no subject line, the first few non-blank lines of the message will be displayed. If there is 
more to the message, you will be told how long it is and asked whether you wish to see the 
rest of the message. The possible responses are: 

y type the rest of the message 

RETURN 

synonym for y. 

n skip this message and go on to the next message. 

— redisplay the last message. 

q drops you out of msgs; the next time you run the program it will pick up where you 
left off. 

8 append the current message to the file “Messages” in the current directory; ‘s-’ will 

save the previously displayed message. A ‘s’ or ‘s-’ may be followed by a space and a 
filename to receive the message replacing the default “Messages”. 

m or ‘m-’ causes a copy of the specified message to be placed in a temporary mailbox 
and mai/(l) to be invoked on that mailbox. Both ‘m’ and ‘s’ accept a numeric argu¬ 
ment in place of the 

Msgs keeps track of the next message you will see by a number in the file .msgsrc in your 
home directory. In the directory /usr/msgs it keeps a set of files whose names are the (sequen¬ 
tial) numbers of the messages they represent. The file /usr/msgs/bounds shows the low and 
high number of the messages in the directory so that msgs can quickly determine if there are 
no messages for you. If the contents of bounds is incorrect it can be fixed by removing it; 
msgs will make a new bounds file the next time it is run. 

Options to msgs include: 

— f which causes it not to say “No new messages.”. This is useful in your .login file since 

this is often the case here. 

—q Queries whether there are messages, printing “There are new messages.” if there are. 

The command “msgs -q” is often used in login scripts. 

— h causes msgs to print the first part of messages only. 

-1 option causes only locally originated messages to be reported. 

num A message number can be given on the command line, causing msgs to start at the 
specified message rather than at the next message indicated by your .msgsrc file. 
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Thus 

msgs -h 1 

prints the first part of all messages. 

-number 

will cause msgs to start number messages back from the one indicated by your .msgsrc 
file, useful for reviews of recent messages. 

—p causes long messages to be piped through more(l). 

Within msgs you can also go to any specific message by typing its number when msgs requests 
input as to what to do. 


FILES 

/usr/msgs/* database 

“/.msgsrc number of next message to be presented 

AUTHORS 

William Joy 
David Wasley 

SEE ALSO 

mail(l), more(l) 
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NAME 

mt - magnetic tape manipulating program 

SYNOPSIS 

mt [ —f tapename ] command [ count ] 

DESCRIPTION 

Mt is used to give commands to the cassette tape drive. If a tape name is not specified, the 
environment variable TAPE is used; if TAPE does not exist, mt uses the device /dev/rctO. 
By default mt performs the requested operation once. Operations may be performed multiple 
times by specifying count. 

The available commands are listed below. Only as many characters as are required to 
uniquely identify a command need be specified. 

eof, weof 

Write count end-of-file marks at the current position on the tape. Note that is 
currently necessary to write end-of-file marks to separate multiple files on the same 
tape. 

fsf Forward space count files, 

fsr Forward space count records. 

fseof Forward space to end of tape. End of tape is defined as the last position written on 
tape. Note that it is necessary to issue this command (instead of fsf ) to add data to 
a tape. 

rewind 

Rewind the tape (Count is ignored.) 
status Print status information about the tape unit. 

Mt returns a 0 exit status when the operation(s) were successful, 1 if the command was 
unrecognized, and 2 if an operation failed. 


FILES 

/dev/ret* Cassette tape interface 


SEE ALSO 

mtio(4), dd(l), ioctl(2), environ(7) 
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NAME 

mv - move or rename files 

SYNOPSIS 

mv [ —i ] [ —f ] [ - ] filel file2 
mv [ —i j [ —f ] [ - ] file ... directory 

DESCRIPTION 

Mv moves (changes the name of) filel to fileS. 

If file2 already exists, it is removed before filel is moved. If fileS has a mode which forbids 
writing, mv prints the mode (see chmod( 2)) and reads the standard input to obtain a line; if 
the line begins with y, the move takes place; if not, mv exits. 

In the second form, one or more files (plain files or directories) are moved to the directory with 
their original file-names. 

Mv refuses to move a file onto itself. 

Options: 

—i stands for interactive mode. Whenever a move is to supercede an existing file, the user 

is prompted by the name of the file followed by a question mark. If he answers with a 
line starting with ’y’> the move continues. Any other reply prevents the move from 
occurring. 

—f stands for force. This option overrides any mode restrictions or the -i switch. 

— means interpret all the following arguments to mv as file names. This allows file 

names starting with minus. 

SEE ALSO 

cp(l), ln(l) 


BUGS 

If filel and fileS lie on different file systems, mv must copy the file and delete the original. In 
this case the owner name becomes that of the copying process and any linking relationship 
with other files is lost. 
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NAME 

netstat - show network status 

SYNOPSIS 

netstat [ —Aahimnrs ] [ —p protocol ] [ — a ] [ interval ] [ system ] [ core ] 

DESCRIPTION 

The netstat command symbolically displays the contents of various network-related data 
structures. The options have the following meaning: 

—A show the address of any associated protocol control blocks; used for debugging 

—a show the state of all sockets; normally sockets used by server processes are not shown 

-h show the state of the IMP host table 

-i show the state of interfaces which have been auto-configured (interfaces statically 
configured into a system, but not located at boot time are not shown) 

—m show statistics recorded by the memory management routines (the network manages a 

“private share” of memory) 

—n show network addresses as numbers (normally netstat interprets addresses and 

attempts to display them symbolically) 

—p proto 

show the state of sockets utilizing protocol proto ; the protocol is specified symbolically, 
and may be any protocol listed in the file / etc/protocols. 

—s show per-protocol statistics 

-r show the routing tables 

The arguments, system and core allow substitutes for the defaults “/vmunix” and 
“/dev/kmem”. 

If an interval is specified, netstat will continuously display the information regarding packet 
traffic on the configured network interfaces, pausing interval seconds before refreshing the 
screen. 

There are a number of display formats, depending on the information presented. The default 
display, for active sockets, shows the local and remote addresses, send and receive queue sizes 
(in bytes), protocol, and, optionally, the internal state of the protocol. 

Address formats are of the form “host.port” or “network.port” if a socket’s address specifies a 
network but no specific host address. When known the host and network addresses are 
displayed symbolically according to the data bases /etc/hosts and / etc/networks, respectively. 
If a symbolic name for an address is unknown, or if the -n option is specified, the address is 
printed in the Internet “dot format”; refer to tne<(3N) for more information regarding this 
format. Unspecified, or “wildcard”, addresses and ports appear as “*”. 

The interface display provides a table of cumulative statistics regarding packets transferred, 
errors, and collisions. The network address (currently Internet specific) of the interface and 
the maximum transmission unit (“mtu”) are also displayed. 

The routing table display indicates the available routes and their status. Each route consists 
of a destination host or network and a gateway to use in forwarding packets. The flags field 
shows the state of the route (“U” if “up”), and whether the route is to a gateway (“G”). 
Direct routes are created for each interface attached to the local host. The refcnt field gives 
the current number of active uses of the route. Connection oriented protocols normally hold 
on to a single route for the duration of a connection while connectionless protocols obtain a 
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route then discard it. The use field provides a count of the number of packets sent using that 
route. The interface entry indicates the network interface utilized for the route. 

When netstat is invoked with an interval argument, it displays a running count of statistics 
related to network interfaces. This display consists of a column summarizing information for 
all interfaces, and a column for the interface with the most traffic since the system was last 
rebooted. The first line of each screen of information contains a summary since the system 
was last rebooted. Subsequent lines of output show values accumulated over the preceding 
interval. 

SEE ALSO 

iostat(l), vmstat(l), hosts(5), networks(5), protocols(5), services(5), trpt(8C) 


BUGS 

The notion of errors is ill-defined. Collisions mean something else for the IMP. 
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NAME 

newaliases - rebuild the data base for the mail aliases file 

SYNOPSIS 

newaliases 

DESCRIPTION 

Newaliases rebuilds the random access data base for the mail aliases file /usr/lib/aliases. It 
must be run each time / usr/lib/aliases is changed in order for the change to take effect. 

SEE ALSO 

aliases(5), sendmail(8) 

BUGS 
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NAME 

nice, nohup - run a command at low priority ( sh only) 

SYNOPSIS 

nice [ —number ] command [ arguments ] 
nohup command [ arguments ] 

DESCRIPTION 

Nice executes command with low scheduling priority. If the number argument is present, the 
priority is incremented (higher numbers mean lower priorities) by that amount up to a limit 
of 20. The default number is 10. 

The super-user may run commands with priority higher than normal by using a negative 
priority, e.g. ‘—10’. 

Nohup executes command immune to hangup and terminate signals from the controlling ter¬ 
minal. The priority is incremented by 5. Nohup should be invoked from the shell with in 
order to prevent it from responding to interrupts by or stealing the input from the next per¬ 
son who logs in on the same terminal. The syntax of nice is also different. 


FILES 

nohup.out standard output and standard error file under nohup 

SEE ALSO 

csh(l), setpriority(2), renice(8) 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 


BUGS 

Nice and nohup are particular to sh( 1). If you use csh(l), then commands executed with 
are automatically immune to hangup signals while in the background. There is a builtin com¬ 
mand nohup which provides immunity from terminate, but it does not redirect output to 
nohup.out. 

Nice is built into cs/i(l) with a slightly different syntax than described here. The form “nice 
4-10” nices to positive nice, and “nice -10” can be used by the super-user to give a process 
more of the processor. 
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NAME 

mn - print name list 

SYNOPSIS 

nm [ —gnopru ] [ file ... ] 


DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argu¬ 
ment is an archive, a listing for each object file in the archive will be produced. If no file is 
given, the symbols in "a.out" are listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U 
(undefined), A (absolute), T (text segment symbol), D (data segment symbol), B (bss segment 
symbol), C (common symbol), f file name, or — for sdb symbol table entries (see —a below). If 
the symbol is local (non-external) the type letter is in lower case. The output is sorted alpha¬ 
betically. 

Options are: 

—g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

—o Prepend file or archive element name to each output line rather than only once. 

—p Don’t sort; print in symbol-table order. 

—r Sort in reverse order. 

—u Print only undefined symbols. 


SEE ALSO 

ar(l), ar(5), a.out(5), stab(5) 
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NAME 

fmt - simple text formatter 
SYNOPSIS 

fmt [ -width ] [ name ... ] 

DESCRIPTION 

Fmt is a simple text formatter which reads the concatenation of input files (or standard input 
if none are given) and produces on standard output a version of its input with lines as close to 
72 characters long as possible. The spacing,at the beginning of the input lines is preserved in 
the output, as are blank lines and interword spacing. A width can be specified to change the 
default of 72 characters. 

Fmt is meant to format mail messages prior to sending, but may also be useful for other sim¬ 
ple tasks. For instance, within visual mode of the ex editor (e.g. vi) the command 
!}fmt 

will reformat a paragraph, evening the lines. 

SEE ALSO 

nroff(l), mail(l) 

AUTHOR 

Kurt Shoens 


BUGS 

The program was designed to be simple and fast - for more complex operations, the standard 
text processors are likely to be more appropriate. 
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NAME 

nroff - text formatting 


SYNOPSIS 

nroff [ option ] ... [ file ] ... 


DESCRIPTION 

Nroff formats text in the named files for typewriter-like devices. See also troff(l). The full 
capabilities of nroff are described in the Nroff/ Troff User’s Manual. 

If no file argument is present, the standard input is read. An argument consisting of a single 
minus (—) is taken to be a file name corresponding to the standard input. 

The options, which may appear in any order so long as they appear before the files, are: 

—olist Print only pages whose page numbers appear in the comma-separated list of 
numbers and ranges. A range N— M means pages N through M] an initial-A means 
from the beginning to page N; and a final N- means from A to the end. 

—nA Number first generated page A. 

-sA Stop every A pages. Nroff will halt prior to every A r pages (default N=l) to allow 
paper loading or changing, and will resume upon receipt of a newline. 

—jnname Prepend the macro file /usr/lib/tmac/tmac. name to the input files. 

—raN Set register a (one-character) to N. 

—i Read standard input after the input files are exhausted. 

— q Invoke the simultaneous input-output mode of the rd request. 

-Tname Prepare output for specified terminal. Known names are 37 for the (default) Tele¬ 
type Corporation Model 37 terminal, tn300 for the GE TermiNet 300 (or any termi¬ 
nal without half-line capability), 300S for the DASI-300S, 300 for the DASI-300, and 
450 for the DASI-450 (Diablo Hyterm). 

—e Produce equally-spaced words in adjusted lines, using full terminal resolution. 

—h Use output tabs during horizontal spacing to speed output and reduce output char¬ 

acter count. Tab settings are assumed to be every 8 nominal character widths. 


FILES 

/tmp/ta* 

/usr/lib/tmac/tmac.* 

/usr/lib/term/* 


temporary file 

standard macro files 

terminal driving tables for nroff 


SEE ALSO 

J. F. Ossanna, Nroff/Troff user’s manual 

B. W. Kernighan, A TROFF Tutorial 

troff(l), eqn(l), tbl(l), ms(7), me(7), man(7), col(l) 
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NAME 

od - octal, decimal, hex, ascii dump 

SYNOPSIS 

od [ -format ] [ file ) [ [+]offset[.][b] [label] ] 

DESCRIPTION 

Od displays file, or it’s standard input, in one or more dump formats as selected by the first 
argument. If the first argument is missing, —o is the default. Dumping continues until end- 
of-file. 

The meanings of the format argument characters are: 

a Interpret bytes as characters and display them with their ACSII names. If the p charac¬ 
ter is given abo, then bytes with even parity are underlined. The P character causes 
bytes with odd parity to be underlined. Otherwise the parity bit is ignored. 

b Interpret bytes as unsigned octal. 

c Interpret bytes as ASCII characters. Certain non-graphic characters appear as C 
escapes: null=\0, backspace=\b, formfeed=\f, newline=\n, return=\r, tab=\t; others 
appear as 3-digit octal numbers. Bytes with the parity bit set are displayed in octal. 

d Interpret (short) words as unsigned decimal, 
f Interpret long words as floating point, 
h Interpret (short) words as unsigned hexadecimal, 
i Interpret (short) words as signed decimal. 

1 Interpret long words as signed decimal, 
o Interpret (short) words as unsigned octal. 

s[n] Look for strings of ascii graphic characters, terminated with a null byte. A r specifies the 
minimum length string to be recognized. By default, the minimum length is 3 charac¬ 
ters. 

v Show all data. By default, display lines that are identical to the last line shown are not 
output, but are indicated w’ith an in column 1. 

w[n] Specifies the number of input bytes to be interpreted and displayed on each output line. 
If w is not specified, 16 bytes are read for each display line. If n is not specified, it 
defaults to 32. 

x Interpret (short) words as hexadecimal. 

An upper case format character implies the long or double precision form of the object. 

The offset argument specifies the byte offset into the file where dumping is to commence. By 
default this argument is interpreted in octal. A different radix can be specified; If is 
appended to the argument, then offset b interpreted in decimal. If offset begins with “x” or 
“Ox”, it is interpreted in hexadecimal. If “b” (“B”) is appended, the offset is interpreted as a 
block count, where a block b 512 (1024) bytes. If the file argument is omitted, an offset argu¬ 
ment must be preceded by “+”. 

The radix of the dbplayed address will be the same as the radix of the offset, if specified; oth¬ 
erwise it will be octal. 

Label will be interpreted as a pseudo-address for the first byte displayed. It will be shown in 
“()” following the file offset. It is intended to be used with core images to indicate the real 
memory address. The syntax for label is identical to that for offset. 
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SEE ALSO 
adb(l) 


BUGS 

A file name argument can’t start with A hexadecimal offset can’t be a block count. 

Only one file name argument can be given. 

It is an historical botch to require specification of object, radix, and sign representation in a 
single character argument. 
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NAME 

pagesize - print system page size 

SYNOPSIS 

pagesize 


DESCRIPTION 

Pagesize prints the size of a page of memory in bytes, as returned by getpagesize{ 2). This pro¬ 
gram is useful in constructing portable shell scripts. 


SEE ALSO 

getpagesize(2) 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd [ name ] 

DESCRIPTION 

This command changes (or installs) a password associated with the user name (your own 
name by default). 

The program prompts for the old password and then for the new one. The caller must supply 
both. The new password must be typed twice, to forestall mistakes. 

New passwords must be at least four characters long if they use a sufficiently rich alphabet 
and at least six characters long if monocase. These rules are relaxed if you are insistent 
enough. 

Only the owner of the name or the super-user may change a password; the owner must prove 
he knows the old password. 


FILES 

/etc/passwd 

SEE ALSO 

login(l), passw’d(5), crypt(3) 

Robert Morris and Ken Thompson, UNIX password security 


BUGS 

The password file information should be kept in a different data structure allowing indexed 
access; dbm(3X) would probably be suitable. 
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NAME 

pc - Pascal compiler 

SYNOPSIS 

pc [ option ] [ — i name ... ] name ... 

DESCRIPTION 

Pc is a Pascal compiler. If given an argument file ending with .p, it will compile the file and 
load it into an executable file called, by default, a.out. 

A program may be separated into more than one .p file. Pc will compile a number of argu¬ 
ment .p files into object files (with the extension .o in place of .p). Object files may then be 
loaded into an executable a.out file. Exactly one object file must supply a program state¬ 
ment to successfully create an executable a.out file. The rest of the files must consist only of 
declarations which logically nest within the program. References to objects shared between 
separately compiled files are allowed if the objects are declared in included header files, whose 
names must end with .h. Header files may only be included at the outermost level, and thus 
declare only globally available objects. To allow functions and procedures to be declared, 
an external directive has been added, whose use is similar to the forward directive but res¬ 
tricted to appear only in .h files. Function and procedure bodies may not appear in .h 
files. A binding phase of the compiler checks that declarations are used consistently, to 
enforce the type checking rules of Pascal. 

Object files created by other language processors may be loaded together with object files 
created by pc. The functions and procedures they define must have been declared in .h 
files included by all the .p files which call those routines. Calling conventions are as in C, 
with var parameters passed by address. 

See the Berkeley Pascal User’s Manual for details. 

The following options have the same meaning as in cc(l) and /77(1). See Zd(l) for load-time 
options. 

-c Suppress loading and produce ‘.o’ file(s) from source file(s). 

—g Have the compiler produce additional symbol table information for c(6x(l). 

-w Suppress warning messages. 

-p Prepare object files for profiling, see prof(l). 

-O Invoke an object-code improver. 

-S Compile the named program, and leave the assembler-language output on the 
corresponding file suffixed ‘.s’. (No ‘.o’ is created.). 

—o output 

Name the final output file output instead of a.out. 

The following options are peculiar to pc. 

—C Compile code to perform runtime checks, verify assert calls, and initialize all variables 

to zero as in pi. 

—b Block buffer the file output. 

—i Produce a listing for the specified procedures, functions and include files. 

-1 Make a program listing during translation. 

—s Accept standard Pascal only; non-standard constructs cause warning diagnostics. 
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-t directory 

Use the given directory for compiler temporary files. 

—z Allow execution profiling with pxp by generating statement counters, and arranging for 

the creation of the profile data file pmon.out when the resulting object is executed. 

Other arguments are taken to be loader option arguments, perhaps libraries of pc compatible 
routines. Certain flags can also be controlled in comments within the program as described in 
the Berkeley Pascal User’s Manual. 


FILES 

file.p 

/usr/lib/pcO 
/lib/fl 
/usr/lib/pc2 
/lib/c2 
/usr/lib/pc3 
/usr/lib / pc2. *strin gs 
/usr/lib/how_pc 
/usr/lib/libpc.a 
/usr/lib/libm.a 
/lib/libc.a 

SEE ALSO 

Berkeley Pascal User’s Manual 
pi(l), pxp(l), pxref(l), sdb(l) 

DIAGNOSTICS 

For a basic explanation do 

pc 

See pi(l). for an explanation of the error message format. Internal errors cause messages con 
taining the word SNARIv. 

AUTHORS 

Charles B. Haley, William N. Joy, and Ken Thompson 

Retargetted to the second pass of the portable C compiler by Peter Kessler 

Runtime library and inline optimizer by M. Kirk McKusick 

Separate compilation consistency checking by Louise Madrid 


pascal source files 

compiler 

code generator 

runtime integrator (inline expander) 
peephole optimizer 

separate compilation consistency checker 
text of the error messages 
basic usage explanation 
intrinsic functions and I/O library 
math library 

standard library, see intro{ 3) 


BUGS 

The keyword packed is recognized but has no effect. 

The binder is not as strict as described here, with regard to the rules about external declara¬ 
tions only in ‘.h’ files and including ‘.h’ files only at the outermost level. It will be made to 
perform these checks in its next incarnation, so users are warned not to be sloppy. 

The -z flag doesn’t work for separately compiled files. 

Because the —s option is usurped by the compiler, it is not possible to pass the strip option to 
the loader. Thus programs which are to be stripped, must be run through strip(l) after they 
are compiled. 
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NAME 

pdx - pascal debugger 

SYNOPSIS 

pdx [—r] [objfile] 

DESCRIPTION 

Pdx is a tool for source level debugging and execution of Pascal programs. The objfile is an 
object file produced by the Pascal translator p»(l). If no objfile is specified, pdx looks for a file 
named “obj” in the current directory. The object file contains a symbol table which includes 
the name of the all the source files translated by pi to create it. These files are available for 
perusal while using the debugger. 

If the file “.pdxinit” exists in the current directory, then the debugger commands in it are exe¬ 
cuted. 

The —r option causes the objfile to be executed immediately; if it terminates successfully pdx 
exits. Otherwise it reports the reason for termination and offers the user the option of enter¬ 
ing the debugger or simply letting px continue with a traceback. If -r is not specified, pdx 
just prompts and waits for a command. 

The commands are: 

run [args] [< filename] [> filename] 

Start executing objfile, passing args as command line arguments; < or > can be used 
to redirect input or output in the usual manner. 

trace [in procedure!function ] [if condition] 
trace source-line-number [if condition] 

trace procedure/function [in procedure/function] [if condition] 
trace expression at source-line-number [if condition] 
trace variable [in procedure/function] [if condition] 

Have tracing information printed when the program is executed. A number is associ¬ 
ated with the command that is used to turn the tracing off (see the delete command). 

The first argument describes what is to be traced. If it is a source-line-number, then 
the line is printed immediately prior to being executed. Source line numbers in a file 
other than the current one must be preceded by the name of the file and a colon, e.g. 
“mumble.p:17”. 

If the argument is a procedure or function name then every time it is called, informa¬ 
tion is printed telling what routine called it, from what source line it was called, and 
what parameters were passed to it. In addition, its return is noted, and if it’s a func¬ 
tion then the value it is returning is also printed. 

If the argument is an expression with an at clause then the value of the expression is 
printed whenever the identified source line is reached. 

If the argument is a variable then the name and value of the variable is printed 
whenever it changes. Execution is substantially slower during this form of tracing. 

If no argument is specified then all source lines are printed before they are executed. 
Execution is substantially slower during this form of tracing. 


ICON INTERNATIONAL 


1 



PDX(l) 


USER COMMANDS 


PDX(l) 



The clause “in procedure!function” restricts tracing information to be printed only 
while executing inside the given procedure or function. 

Condition is a Pascal boolean expression and is evaluated prior to printing the tracing 
information; if it is false then the information is not printed. 

There is no restriction on the amount of information that can be traced, 
stop if condition 

stop at source-line-number [if condition] 
stop in procedure!function [if condition] 
stop variable [if condition] 

Stop execution when the given line is reached, procedure or function called, variable 
changed, or condition true. 

delete command-number 

The trace or stop corresponding to the given number is removed. The numbers associ¬ 
ated with traces and stops are printed by the status command. 

status [> filename] 

Print out the currently active trace and stop commands. 

cont Continue execution from where it stopped. This can only be done when the program 
was stopped by an interrupt or through use of the stop command. 

step Execute one source line. 

next Execute up to the next source line. The difference between this and step is that if the 
line contains a call to a procedure or function the step command will stop at the 
beginning of that block, while the next command will not. 

print expression [, expression ...] 

Print out the values of the Pascal expressions. Variables declared in an outer block 
but having the same identifier as one in the current block may be referenced as 
“ block-name . variable ”. 

whatis identifier 

Print the declaration of the given identifier, 
which identifier 

Print the full qualification of the given identifer, i.e. the outer blocks that the 
identifier is associated with. 

assign variable expression 

Assign the value of the expression to the variable. 

call procedure(parameters) 

Execute the object code associated with the named procedure or function, 
help Print out a synopsis of pdx commands. 

gripe Invokes a mail program to send a message to the person in charge of pdx. 

where Print out a list of the active procedures and functions and the respective source line 
where they are called. 

source filename 

Read pdx commands from the given filename. Especially useful when the filename has 
been created by redirecting a status command from an earlier debugging session. 

dump [> filename] 

Print the names and values of all active data. 
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list [ source-line-number [, source-line-number]] 
list procedure/function 

List the lines in the current source file from the first line number to the second 
inclusive. As in the editor “$” can be used to refer to the last line. If no lines are 
specified, the entire file is listed. If the name of a procedure or function is given lines 
n-k to n+k are listed where n is the first statement in the procedure or function and k 
is small. 

file [filename ] 

Change the current source file name to filename. If none is specified then the current 
source file name is printed. 

edit [filename] 

edit procedure/function-name 

Invoke an editor on filename or the current source file if none is specified. If a pro¬ 
cedure or function name is specified, the editor is invoked on the file that contains it. 
Which editor is invoked by default depends on the installation. The default can be 
overridden by setting the environment variable EDITOR to the name of the desired 
editor. 

pi Recompile the program and read in the new symbol table information, 
sh command-line 

Pass the command line to the shell for execution. The SHELL environment variable 
determines which shell is used. 

alias new-command-name old-command-name 

This command makes pdx respond to new-command-name the way it used to respond 
to old-command-name. 

quit Exit pdx. 


The following commands deal with the program at the px instruction level rather than source 
level. They are not intended for general use. 

tracei [address] [if cond\ 
tracei [variable] [at address] [if cond] 
stopi address\ [if cond] 
stopi [at] [acWress] [if cond] 

Turn on tracing or set a stop using a px machine instruction addresses, 
xi address [, address] 

Print the instructions starting at the first address. Instructions up to the second 
address are printed. 

xd address [, address] 

Print in octal the specified data location(s). 

FILES 

obj Pascal object file 

.pdxinit Pdx initialization file 
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SEE ALSO 

pi(l), px(l) 

An Introduction to Pdx 


BUGS 

Pdx does not understand sets, and provides no information about files. 

The whatis command doesn’t quite work for variant records. 

Bad things will happen if a procedure invoked with the call command does a non-local goto. 

The commands step and next should be able to take a count that specifies how many lines to 
execute. 

There should be commands stepi and nexti that correspond to step and next but work at 
the instruction level. 

There should be a way to get an address associated with a line number, procedure or function, 
and variable. 

Most of the command names are too long. 

The alias facility is quite weak. 

A csh- like history capability would improve the situation. 
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NAME 

pi - Pascal interpreter code translator 

SYNOPSIS 

pi [ option ] [ —i name ... ] name.p 
DESCRIPTION 

Pi translates the program in the file name.p leaving interpreter code in the file obj in the 
current directory. The interpreter code can be executed using px. Pix performs the functions 
of pi and px for ‘load and go’ Pascal. 

The following flags are interpreted by pi; the associated options can also be controlled in com¬ 
ments within the program as described in the Berkeley Pascal User’s Manual. 

—b Block buffer the file output. 

—i Enable the listing for any specified procedures and functions and while processing any 

specified include files. 

—1 Make a program listing during translation. 

— n Begin each listed include file on a new page with a banner line. 

—p Suppress the post-mortem control flow backtrace if an error occurs; suppress statement 
limit counting. 

—s Accept standard Pascal only; non-standard constructs cause warning diagnostics. 

—t Suppress runtime tests of subrange variables and treat assert statements as comments, 

-u Card image mode; only the first 72 characters of input lines are used. 

—w Suppress warning diagnostics. 

—z Allow execution profiling with pxp by generating statement counters, and arranging for 
the creation of the profile data file pmon.out when the resulting object is executed. 

FILES 

file.p 
file.i 

/usr/lib/pi2.*strings 
/usr/lib/how_pi* 
obj 

SEE ALSO 

Berkeley Pascal User’s Manual 
pix(l), px(l), pxp(l), pxref(l) 

DIAGNOSTICS 

For a basic explanation do 

Pi 

In the diagnostic output of the translator, lines containing syntax errors are listed with a flag 
indicating the point of error. Diagnostic messages indicate the action which the recovery 
mechanism took in order to be able to continue parsing. Some diagnostics indicate only that 
the input is ‘malformed.’ This occurs if the recovery can find no simple correction to make the 
input syntactically valid. 


input file 

include file(s) 

text of the error messages 

basic usage explanation 

interpreter code output 
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Semantic error diagnostics indicate a line in the source text near the point of error. Some 
errors evoke more than one diagnostic to help pinpoint the error; the follow-up messages begin 
with an ellipsis 

The first character of each error message indicates its class: 

E Fatal error; no code will be generated, 

e Non-fatal error, 

w Warning - a potential problem, 

s Non-standard Pascal construct warning. 

If a severe error occurs which inhibits further processing, the translator will give a diagnostic 
and then ‘QUIT’. 

AUTHORS 

Charles B. Haley, William N. Joy, and Ken Thompson 
Ported to VAX-11 by Peter Kessler 


BUGS 

The keyword packed is recognized but has no effect. 

For clarity, semantic errors should be flagged at an appropriate place in the source text, and 
multiple instances of the ‘same’ semantic error should be summarized at the end of a pro¬ 
cedure or function rather than evoking many diagnostics. 

When include files are present, diagnostics relating to the last procedure in one file may 
appear after the beginning of the listing of the next. 
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NAME 

pix - Pascal interpreter and executor 

SYNOPSIS 

pix [ — blnpstuwz ] [ -i name ... ] name.p [ argument ... ] 

DESCRIPTION 

Pix is a ‘load and go’ version of Pascal which combines the functions of the interpreter code 
translator pi and the executor px. It uses pi to translate the program in the file name.p and, 
if there were no fatal errors during translation, causes the resulting interpreter code to be exe¬ 
cuted by px with the specified arguments. A temporary file is used for the object code; the file 
obj is neither created nor destroyed. 


FILES 

/usr/ucb/pi 

/usr/ucb/px 

/tmp/pix* 

/usr/lib/how_pix 


Pascal translator 
Pascal executor 
temporary 
basic explanation 


SEE ALSO 

Berkeley Pascal User’s Manual 
pi(l), px(l) 


DIAGNOSTICS 

For a basic explanation do 

pix 


AUTHORS 

Susan L. Graham and William N. Joy 
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NAME 

plot - graphics filters 

SYNOPSIS 

plot [ -Tterminal [ raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see plot(5)) from the standard input, and in gen¬ 
eral produce plotting instructions suitable for a particular terminal on the standard output. 

If no terminal type is specified, the environment parameter STERM (see environ{l )) is used. 
Known terminals are: 

4014 Tektronix 4014 storage scope. 

450 DASI Hyterm 450 terminal (Diablo mechanism). 

300 DASI 300 or GSI terminal (Diablo mechanism). 

300S DASI 300S terminal (Diablo mechanism). 

ver Versatec D1200A printer-plotter. This version of plot places a scan-converted image in 
‘/usr/tmp/raster’ and sends the result directly to the plotter device rather than to the 
standard output. The optional argument causes a previously scan-converted file raster 
to be sent to the plotter. 


FILES 

/usr/bin/tek 

/usr/bin/t450 

/usr/bin/t300 

/usr/bin/t300s 

/usr/bin/vplot 

/usr/tmp/raster 

SEE ALSO 

plot(3X), plot(5) 


BUGS 

There is no lockout protection for /usr/tmp/raster. 
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NAME 

pmerge - pascal file merger 

SYNOPSIS 

pmerge name.p ... 




DESCRIPTION 

Pmerge assembles the named Pascal files into a single standard Pascal program. The resulting 
program is listed on the standard output. It is intended to be used to merge a collection of 
separately compiled modules so that they can be run through pi , or exported to other sites. 


FILES 

/usr/tmp/MG* default temporary files 

SEE ALSO 

pc(l), pi(l), 

Auxiliary documentation Berkeley Pascal User’s Manual. 

AUTHOR 

M. Kirk McKusick 


BUGS 

Very minimal error checking is done, so incorrect programs will produce unpredictable results. 
Block comments should be placed after the keyword to which they refer or they are likely to 
end up in bizarre places. 


/ , 
''v_ J 
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NAME 

pr - print file 

SYNOPSIS 

pr [ option ] ... [ file ] ... 

DESCRIPTION 

Pr produces a printed listing of one or more files. The output is separated into pages headed 
by a date, the name of the file or a specified header, and the page number. If there are no file 
arguments, pr prints its standard input. 

Options apply to all following files but may be reset between files: 

—n Produce n-column output. 

+ n Begin printing with page n. 

—h Take the next argument as a page header. 

-wn For purposes of multi-column output, take the width of the page to be n characters 
instead of the default 72. 

—f Use formfeeds instead of newlines to separate pages. A formfeed is assumed to use up 
two blank lines at the top of a page. (Thus this option does not affect the effective 
page length.) 

—In Take the length of the page to be n lines instead of the default 66. 

—t Do not print the 5-line header or the 5-line trailer normally supplied for each page. 

-sc Separate columns by the single character c instead of by the appropriate amount of 

white space. A missing c is taken to be a tab. 

-m Print all files simultaneously, each in one column, 

In ter-terminal messages via write{\) are forbidden during a pr. 


FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

cat(l) 


DIAGNOSTICS 

There are no diagnostics when pr is printing on a terminal. 
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NAME 

print - pr to the printer 

SYNOPSIS 

print file ... 

DESCRIPTION 

Print pr’s a copy of each named file on the printer. It is a one line shell script: 
lpr -p $* 

SEE ALSO 

lpr(l), pr(l) 
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NAME 

printenv - print out the environment 

SYNOPSIS 

printenv [ name ] 

DESCRIPTION 

Printenv prints out the values of the variables in the environment. If a name is specified, only 
its value is printed. 

If a name is specified and it is not defined in the environment, printenv returns exit status 1, 
else it returns status 0. 

SEE ALSO 

sh(l), environ(7), csh(l) 
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SYNOPSIS 

prmail [ user ... ] 

DESCRIPTION 

Prmail prints the mail which waits for you, or the specified user, in the post office. The mail 
is not disturbed. 

FILES 

/usr/spool/mail/* post office 

SEE ALSO 

biff(l), mail(l), from(l), binmail(l) 


NAME 

prmail - print out mail in the post office t 
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NAME 

prof - display profile data 

SYNOPSIS 

prof [ —a ] [ — 1 ] [ — n ] [ — * ] [ — s ] [ — v [ —low [ — high ] j ] [ a.out [ mon.out. ... ] ] 

DESCRIPTION 

Prof interprets the file produced by the monitor subroutine. Under default modes, the symbol 
table in the named object file (a.out default) is read and correlated with the profile file 
(mon.out default). For each external symbol, the percentage of time spent executing between 
that symbol and the next is printed (in decreasing order), together with the number of times 
that routine was called and the number of milliseconds per call. If more than one profile file is 
specified, the output represents the sum of the profiles. 

In order for the number of calls to a routine to be tallied, the —p option of cc, f77 or pc must 
have been given when the file containing the routine was compiled. This option also arranges 
for the profile file to be produced automatically. 

Options are: 

—a all symbols are reported rather than just external symbols. 

-1 the output is sorted by symbol value. 

—n the output is sorted by number of calls 

—s a summary profile file is produced in mon.sum. This is really only useful when more 
than one profile file is specified. 

-v all printing is suppressed and a graphic version of the profile is produced on the stan¬ 
dard output for display by the plot( 1) filters. When plotting, the numbers low and 
high, by default 0 and 100, may be given to cause a selected percentage of the profile 
to be plotted with accordingly higher resolution. 

—z routines which have zero usage (as indicated by call counts and accumulated time) are 
nevertheless printed in the output. 

FILES 

mon.out for profile 
a.out for namelist 
mon.sum for summary profile 

SEE ALSO 

monitor(3), profil(2), cc(l), plot(lG) 


BUGS 

Beware of quantization errors. 


Is confused by f77 which puts the entry points at the bottom of subroutines and functions. 
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NAME 

ps - process status 

SYNOPSIS 

ps [ acegklstuvwx# ] 

DESCRIPTION 

Ps prints information about processes. Normally, only your processes are candidates to be 
printed by ps; specifying a causes other users processes to be candidates to be printed; specify¬ 
ing x includes processes without control terminals in the candidate pool. 

All output formats include, for each process, the process id PID, control terminal of the pro¬ 
cess TT, cpu time used by the process TIME (this includes both user and system time), the 
state STAT of the process, and an indication of the COMMAND which is running. The state 
is given by a sequence of four letters, e.g. “RWNA”. The first letter indicates the runnability 
of the process: R for runnable processes, T for stopped processes, P for processes in page wait, 
D for those in disk (or other short term) waits, S for those sleeping for less than about 20 
seconds, and I for idle (sleeping longer than about 20 seconds) processes. The second letter 
indicates whether a process is swapped out, showing W if it is, or a blank if it is loaded (in- 
core); a process which has specified a soft limit on memory requirements and which is exceed¬ 
ing that limit shows >; such a process is (necessarily) not swapped. The third letter indicates 
whether a process is running with altered CPU scheduling priority (nice); if the process prior¬ 
ity is reduced, an N is shown, if the process priority has been artificially raised then a '<’ is 
shown; processes running without special treatment have just a blank. The final letter is not 
used in this version. 

Here are the options: 

a asks for information about all processes with terminals (ordinarily only one’s own 
processes are displayed). 

c prints the command name, as stored internally in the system for purposes of accounting, 
rather than the command arguments, which are kept in the process’ address space. This 
is more reliable, if less informative, since the process is free to destroy the latter informa¬ 
tion. 

e Asks for the environment to be printed as well as the arguments to the command. 

g Asks for all processes. Without this option, ps only prints “interesting” processes. 

Processes are deemed to be uninteresting if they are process group leaders. This nor¬ 
mally eliminates top-level command interpreters and processes waiting for users to login 
on free terminals. 

k causes the file /vmcore is used in place of /dev/kmem and /dev/mem. This is used for 
postmortem system debugging. 

1 asks for a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN 
as described below. 

s Adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to 
the basic output format. 

tx restricts output to processes whose controlling tty is x (which should be specified as 

printed by ps, e.g. tS for tty3, too for console, tdO for ttydO, t? for processes with no 

tty, t for processes at the current tty, etc). This option must be the last one given. 

u A user oriented output is produced. This includes fields USER, %CPU, NICE, SIZE, 
and RSS as described below. 
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v A version of the output containing virtual memory statistics is output. This includes 

fields RE, SL, PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, <%CPU and %MEM, described 
below. 

w Use a wide output format (132 columns rather than 80); if repeated, e.g. ww, use arbi¬ 

trarily wide output. This information is used to decide how much of long commands to 
print. 

x asks even about processes with no terminal. 

# A process number may be given, (indicated here by #), in which case the output is res¬ 
tricted to that process. This option must also be last. 

A second argument is taken to be the file containing the system’s namelist. Otherwise, 
/vmunix is used. A third argument tells ps where to look for core if the k option is given, 
instead of /vmcore. If a fourth argument is given, it is taken to be the name of a swap direc¬ 
tory to use instead of the default. 

Fields which are not common to all output formats: 

USER name of the owner of the process 

%CPU cpu utilization of the process; this is a decaying average over up to a minute of 
previous (real) time. Since the time base over which this is computed varies (since 
processes may be very young) it is possible for the sum of all %CPU fields to 
exceed 100%. 

NICE (or NI) process scheduling increment (see setpriority( 2)) 

SIZE virtual size of the process (in 1024 byte units) 

RSS real memory (resident set) size of the process (in 1024 byte units) 

LIM soft limit on memory used, specified via a call to setrlimit{2 ); if no limit has been 

specified then shown as xx 
TSIZ size of text (shared program) image 
TRS size of resident (real memory) set of text 

%MEM percentage of real memory used by this process. 

RE residency time of the process (seconds in core) 

SL sleep time of the process (seconds blocked) 

PAGEIN number of disk i/o’s resulting from references by the process to pages not loaded 
in core. 

UID numerical user-id of process owner 

PPID numerical id of parent of process 

CP short-term cpu utilization factor (used in scheduling) 

PRI process priority (non-positive when in non-interruptible wait) 

ADDR swap address of the process 

WCHAN event on which process is waiting (an address in the system). 

F flags associated with process as in <sys/proc.h>: 

SLOAD 0000001 in core 

SSYS 0000002 swapper or pager process 

SLOCK 0000004 process being swapped out 
STRC 0000008 process is being traced 

SWTED 0000010 another tracing flag 

SULOCK 0000020 user settable lock in core 
SOMASK 0000040 restore old mask after signal 
SWEXIT 0000080 working on exiting 

SVFORK 0000100 process resulted from vforkQ 

SOWEUPC 0000200 owe process an addupc() at next ast 
SLOGIN 0000400 login process (legit child of in it) 
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SSUPER 

STHRASH 

STWIN 

SDELTA 

SDELLOCK 

SINTR 

SSEL 


0000800 process has supervisor state 

0001000 is a thrasher 

0002000 is a twin process 

0004000 has delta segments 

0008000 locked while mucking with segments 

0010000 is an interactive process 

0400000 selecting; wakeup/waiting danger 


A process that has exited and has a parent, but has not yet been waited for by the parent is 
marked <defunct>; a process which is blocked trying to exit is marked <exiting>; Ps 
makes an educated guess as to the file name and arguments given when the process was 
created by examining memory or the swap area. The method is inherently somewhat unreli¬ 
able and in any event a process is entitled to destroy this information, so the names cannot be 
counted on too much. 


FILES 

/vmunix 
/dev/kmem 
/dev/swap 
/vmcore 
/dev 


system namelist 
kernel memory 
swap directory 
core file 

searched to find tty names 


SEE ALSO 

kill(l), w(l) 


BUGS 

Things can change while ps is running; the picture it gives is only a close approximation to 
reality. 


■if ~\ 
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NAME 

pti - phototypesetter interpreter 

SYNOPSIS 

pti [ file ... ] 

DESCRIPTION 

Pti shows the commands in a stream from the standard output of troff{ l) using troff’s -t 
option, interpreting them as they would act on the typesetter. Horizontal motions shows as 
counts in internal units and are marked with “<’ and *>’ indicating left and right motion. 
Vertical space is called lead and is also indicated. 

SEE ALSO 

troff(l) 


BUGS 

Too cryptic for normal users, who should use “troff -a ...”. 
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NAME 

ptx - permuted index 

SYNOPSIS 

ptx [ option ] ... [ input [ output ] ] 

DESCRIPTION 

Ptx generates a permuted index to file input on file output (standard input and output 
default). It has three phases: the first does the permutation, generating one line for each key¬ 
word in an input line. The keyword is rotated to the front. The permuted file is then sorted. 
Finally, the sorted lines are rotated so the keyword comes at the middle of the page. Ptx pro¬ 
duces output in the form: 

.xx "tail" "before keyword" "keyword and after" "head" 

where .xx may be an nroff or troff(l) macro for user-defined formatting. The before keyword 
and keyword and after fields incorporate as much of the line as will fit around the keyword 
w'hen it is printed at the middle of the page. Tail and head, at least one of which is an empty 
string "", are w r rapped-around pieces small enough to fit in the unused space at the opposite 
end of the line. When original text must be discarded, ‘/’ marks the spot. 

The following options can be applied: 

—f Fold upper and lower case letters for sorting. 

—t Prepare the output for the phototypesetter; the default line length is 100 characters. 

—w n Use the next argument, n, as the width of the output line. The default line length is 
72 characters. 

—g n Use the next argument, n, as the number of characters to allow for each gap among 
the four parts of the line as finally printed. The default gap is 3 characters. 

—o only 

Use as keywords only the words given in the only file. 

—i ignore 

Do not use as keywords any words given in the ignore file. If the -i and —o options 
are missing, use /usr/lib/eign as the ignore file. 

-b break 

Use the characters in the break file to separate w'ords. In any case, tab, newline, and 
space characters are always used as break characters. 

-r Take any leading nonblank characters of each input line to be a reference identifier (as 
to a page or chapter) separate from the text of the line. Attach that identifier as a 5th 
field on each output line. 

The index for this manual was generated using ptx. 


FILES 

/usr/bin/sort 

/usr/lib/eign 


BUGS 

Line length counts do not account for overstriking or proportional spacing. 
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NAME 

pwd - working directory name 

SYNOPSIS 

pwd 


DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 


SEE ALSO 

cd(l), csh(l), getwd(3) 


BUGS 

In csh(l) the command dirs is always faster (although it can give a different answer in the rare 
case that the current directory or a containing directory was moved after the shell descended 
into it). 
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NAME 

px - Pascal interpreter 

SYNOPSIS 

px [ obj [ argument ... ] ] 

DESCRIPTION 

Px interprets the abstract machine code generated by pi. The first argument is the file to be 
interpreted, and defaults to obj ; remaining arguments are available to the Pascal program 
using the built-ins argv and argc. Px is also invoked by pix when running ‘load and go’. 

If the program terminates abnormally an error message and a control flow backtrace are 
printed. The number of statements executed and total execution time are printed after nor¬ 
mal termination. The p option of pi suppresses all of this except the message indicating the 
cause of abnormal termination. 


FILES 

obj default object file 

pmon.out profile data file 

SEE ALSO 

Berkeley Pascal User’s Manual 
pi(l), pix(l) 

DIAGNOSTICS 

Most run-time error messages are self-explanatory. Some of the more unusual ones are: 
Reference to an inactive file 

A file other than input or output was used before a call to reset or rewrite. 

Statement count limit exceeded 

The limit of 500,000 executed statements (which prevents excessive looping or recur¬ 
sion) has been exceeded. 

Bad data found on integer read 
Bad data found on real read 

Usually, non-numeric input was found for a number. For reals, Pascal requires digits 
before and after the decimal point so that numbers like ‘.1’ or ‘21.’ evoke the second 
diagnostic. 

panic: Some message 

Indicates a internal inconsistency detected in px probably due to a Pascal system bug. 


AUTHORS 

Charles B. Haley, William Joy, and Ken Thompson 
VAX-11 version by Kirk McKusick 


BUGS 

Post-mortem traceback is not limited; infinite recursion leads to almost infinite traceback. 
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NAME 

pxp - Pascal execution profiler 

SYNOPSIS 

pxp [ -acdefjnstuw_ ] [ -23456789 ] [ — z [ name ... ] ] name.p 
DESCRIPTION 

Pxp can be used to obtain execution profiles of Pascal programs or as a pretty-printer. To 
produce an execution profile all that is necessary is to translate the program specifying the z 
option to pi or pix, to execute the program, and to then issue the command 

pxp —i name.p 

A reformatted listing is output if none of the c, t, or z options are specified; thus 
pxp old.p > new.p 

places a pretty-printed version of the program in ‘old.p’ in the file ‘new.p’. 

The use of the following options of pxp is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the 
Berkeley Pascal User’s Manual. 

—a Print the bodies of all procedures and functions in the profile; even those which were 
never executed. 

—c Extract profile data from the file core. 

-d Include declaration parts in a profile. 

-e Eliminate include directives when reformatting a file; the include is replaced by the 
reformatted contents of the specified file. 

— f Fully parenthesize expressions. 

-j Left justify all procedures and functions. 

—n Eject a new page as each file is included; in profiles, print a blank line at the top of the 
page. 

—s Strip comments from the input text. 

— t Print a table summarizing procedure and function call counts. 

-u Card image mode; only the first 72 characters of input lines are used. 

—w Suppress warning diagnostics. 

—z Generate an execution profile. If no names, are given the profile is of the entire pro¬ 
gram. If a list of names is given, then only any specified procedures or functions 
and the contents of any specified include files will appear in the profile. 

—_ Underline keywords. 

— d With d a digit, 2 < d < 9, causes pxp to use d spaces as the basic indenting unit. The 
default is 4. 


FILES 


name.p input file 

name.i include file(s) 

pmon.out profile data 

core profile data source with -c 

/usr/lib/how_pxp information on basic usage 
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SEE ALSO 

Berkeley Pascal User’s Manual 
pi(l), px(l) 

DIAGNOSTICS 

For a basic explanation do 

pxp 

Error diagnostics include ‘No profile data in file’ with the c option if the z option was not 
enabled to pi; ‘Not a Pascal system core file’ if the core is not from a px execution; ‘Program 
and count data do not correspond’ if the program was changed after compilation, before 
profiling; or if the wrong program is specified. 


AUTHOR 

William Joy 


BUGS 

Does not place multiple statements per line. 
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NAME 

pxref - Pascal cross-reference program 

SYNOPSIS 

pxref [ - ] name 

DESCRIPTION 

Pxref makes a line numbered listing and a cross-reference of identifier usage for the program 
in name. The optional ’ argument suppresses the listing. The keywords goto and label are 
treated as identifiers for the purpose of the cross-reference. Include directives are not pro¬ 
cessed, but cause the placement of an entry indexed by ‘^include’ in the cross-reference. 

SEE ALSO 

Berkeley Pascal User’s Manual 

AUTHOR 

Niklaus Wirth 


BUGS 

Identifiers are trimmed to 10 characters. 
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NAME 

quota - display disc usage and limits 

SYNOPSIS 

quota [ —qv ] [ user ] 


DESCRIPTION 

Quota displays users’ disc usage and limits. Only the super-user may use the optional user 
argument to view the limits of users other than himself. 

The -q flag prints a more terse message, containing only information on file systems where 
usage is over quota. 

If a —v flag is supplied, quota will also display user’s quotas on file systems where no storage is 
allocated. 

Quota reports only on file systems which have disc quotas. If quota exits with a. non-zero 
status, one or more file systems are over quota. 


SEE ALSO 

quota(2), quotaon(8) 
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NAME 

ranlib - convert archives to random libraries 

SYNOPSIS 

ranlib archive ... 

DESCRIPTION 

Ranlib converts each archive to a form which the loader can load more rapidly. Ranlib does 
this by adding a table of contents called _.SYMDEF to the beginning of the archive. Ranlib 
uses ar(l) to reconstruct the archive, so that sufficient temporary file space must be available 
in the file system which contains the current directory. 

SEE ALSO 

ld(l), ar(l), lorder(l) 


BUGS 

Because generation of a library by ar and randomization of the library by ranlib are separate 
processes, phase errors are possible. The loader, Id, warns when the modification date of a 
library is more recent than the creation date of its dictionary; but this means that you get 
the warning even if you only copy the library. 
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NAME 

ratfor - rational Fortran dialect 

SYNOPSIS 

ratfor [ option ... ] [ filename ... ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides 
control flow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

loops: while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment 

translation of relationals: 

>, >=, etc., become .GT., ,GE., etc. 

return (expression) 

returns expression to caller from function 
define: define name replacement 
include: 

include filename 
Ratfor is best used with /77(l). 

SEE ALSO 
177(1) 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

rep - remote file copy 

SYNOPSIS 

rep filel file2 

rep [ — r ] file ... directory 

DESCRIPTION 

Rep copies files between machines. Each file or directory argument is either a remote file name 
of the form “rhost:path”, or a local file name (containing no V characters, or a ‘/’ before any 
Vs.) 

If the —r is specified and any of the source files are directories, rep copies each subtree rooted 
at that name; in this case the destination must be a directory. 

If path is not a full path name, it is interpreted relative to your login directory on rhost. A 
path on a remote host may be quoted (using \, ", or ') so that the metacharacters are inter¬ 
preted remotely. 

Rep does not prompt for passwords; your current local user name must exist on rhost and 
allow remote command execution via rsh(lC). 

Rep handles third party copies, where neither source nor target files are on the current 
machine. Hostnames may also take the form “rhost.rname” to use rname rather than the 
current user name on the remote host. 

SEE ALSO 

ftp(lC), rsh(lC), rlogin(lC) 


BUGS 

Doesn’t detect all cases where the target of a copy might be a file in cases where only a direc¬ 
tory should be legal. 

Is confused by any output generated by commands in a .login, .profile, or .eshre file on the 
remote host. 
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NAME 

res - change RCS file attributes 

SYNOPSIS 

res [ options ] file ... 

DESCRIPTION 

Res creates new RCS files or changes attributes of existing ones. An RCS file contains multi¬ 
ple revisions of text, an access list, a change log, descriptive text, and some control attributes. 
For res to work, the caller’s login name must be on the access list, except if the access list is 
empty, the caller is the owner of the file or the superuser, or the -i option is present. 

Files ending in ‘,v’ are RCS files, all others are working files. If a working file is given, res tries 
to find the corresponding RCS file first in directory ./RCS and then in the current directory, 
as explained in co (1). 

—i creates and initializes a new RCS file, but does not deposit any revision. If the 

RCS file has no path prefix, res tries to place it first into the subdirectory ./RCS, 
and then into the current directory. If the RCS file already exists, an error mes¬ 
sage is printed. 

-a logins appends the login names appearing in the comma-separated list logins to the 
access list of the RCS file. 

appends the access list of oldfile to the access list of the RCS file. 

erases the login names appearing in the comma-separated list logins from the 
access list of the RCS file. If logins is omitted, the entire access list is erased. 

sets the comment leader to string. The comment leader is printed before every log 
message line generated by the keyword $Log$ during checkout (see co). This is 
useful for programming languages without multi-line comments. During res -i or 
initial ci, the comment leader is guessed from the suffix of the working file. 

locks the revision with number rev. If a branch is given, the latest revision on 
that branch is locked. If rev is omitted, the latest revision on the trunk is locked. 
Locking prevents overlapping changes. A lock is removed with ci or res -u (see 
below). 

unlocks the revision with number rev. If a branch is given, the latest revision on 
that branch is unlocked. If ret; is omitted, the latest lock held by the caller is 
removed. Normally, only the locker of a revision may unlock it. Somebody else 
unlocking a revision breaks the lock. This causes a mail message to be sent to the 
original locker. The message contains a commentary solicited from the breaker. 
The commentary is terminated with a line containing a single or control-D. 

sets locking to strict. Strict locking means that the owner of an RCS file is not 
exempt from locking for checkin. This option should be used for files that are 
shared. 

—U sets locking to non-strict. Non-strict locking means that the owner of a file need 

not lock a revision for checkin. This option should NOT be used for files that are 
shared. The default (-L or -U) is determined by your system administrator. 

—nname[:rev] 

associates the symbolic name name with the branch or revision ret;. Res prints an 
error message if name is already associated with another number. If rev is omit¬ 
ted, the symbolic name is deleted. 


-A oldfile 
—e\logins] 

—cstrmg 

—lfret;] 

—u[reu] 

-L 


ICON INTERNATIONAL 


1 




RCS(1) 


USER COMMANDS 


RCS(1) 


—Nname[:ret;] 

same as -n, except that it overrides a previous assignment of name. 

—o range deletes ("outdates") the revisions given by range. A range consisting of a single 

revision number means that revision. A range consisting of a branch number 
means the latest revision on that branch. A range of the form revl-revS means 
revisions revl to rev2 on the same branch, -rev means from the beginning of the 
branch containing rev up to and including rev, and rev- means from revision rev 
to the end of the branch containing rev. None of the outdated revisions may 
have branches or locks. 

quiet mode; diagnostics are not printed. 

sets the state attribute of the revision ret; to state. If rev is omitted, the latest 
revision on the trunk is assumed; If rev is a branch number, the latest revision on 
that branch is assumed. Any identifier is acceptable for state. A useful set of 
states is Exp (for experimental), Stab (for stable), and Rel (for released). By 
default, ci sets the state of a revision to Exp. 

writes descriptive text into the RCS file (deletes the existing text). If txtfile is 
omitted, res prompts the user for text supplied from the std. input, terminated 
with a line containing a single or control-D. Otherwise, the descriptive text is 
copied from the file txtfile. If the -i option is present, descriptive text is requested 
even if -t is not given. The prompt is suppressed if the std. input is not a termi¬ 
nal. 

DIAGNOSTICS 

The RCS file name and the revisions outdated are written to the diagnostic output. The exit 
status always refers to the last RCS file operated upon, and is 0 if the operation was success¬ 
ful, 1 otherwise. 


-q 

—s state[:rev] 


—t [txtfile] 


FILES 

The caller of the command must have read/write permission for the directory containing the 
RCS file and read permission for the RCS file itself. Res creates a semaphore file in the same 
directory as the RCS file to prevent simultaneous update. For changes, res always creates a 
new file. On successful completion, res deletes the old one and renames the new one. This 
strategy makes links to RCS files useless. 

IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 3.1 ; Release Date: 83/04/04 . 

Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

co (1), ci (1), ident(l), resdiff (1), rcsintro (1), resmerge (1), rlog (1), resfile (5), sccstorcs (8). 
Walter F. Tichy, 'Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 


BUGS 
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NAME 

rcsdiff - compare RCS revisions 
SYNOPSIS 

rcsdiff [ -biwt ] [ — cefhn ] [ —r revl ] [ —rrevS ] file ... 

DESCRIPTION 

Rcsdiff runs diff (1) to compare two revisions of each RCS file given. A file name ending in 
’,v’ is an RCS file name, otherwise a working file name. Rcsdiff derives the working file name 
from the RCS file name and vice versa, as explained in co (1). Pairs consisting of both an RCS 
and a working file name may also be specified. 

All options except -r have the same effect as described in diff[ 1). 

If both revl and rev2 are omitted, rcsdiff compares the latest revision on the trunk with the 
contents of the corresponding working file. This is useful for determining what you changed 
since the last checkin. 

If revl is given, but rev2 is omitted, rcsdiff compares revision revl of the RCS file with the 
contents of the corresponding working file. 

If both revl and rev2 are given, rcsdiff compares revisions revl and rev2 of the RCS file. 

Both revl and rev2 may be given numerically or symbolically. 

EXAMPLES 

The command 

rcsdiff f.c 

runs diff on the latest trunk revision of RCS file f.c,v and the contents of working file f.c. 
IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 1.2 ; Release Date: 86/05/19 . 

Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

ci (l), co (l), diff (1), ident (1), res (1), rcsintro (1), resmerge (1), rlog (l), resfile (5). 

Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 

BUGS 
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NAME 

rcsintro - introduction to RCS commands 
DESCRIPTION 

The Revision Control System (RCS) manages multiple revisions of text files. RCS automates 
the storing, retrieval, logging, identification, and merging of revisions. RCS is useful for text 
that is revised frequently, for example programs, documentation, graphics, papers, form 
letters, etc. 

The basic user interface is extremely simple. The novice only needs to learn two commands: ci 
and co. Ci, short for "checkin”, deposits the contents of a text file into an archival file called 
an RCS file. An RCS file contains all revisions of a particular text file. Co, short for 
"checkout", retrieves revisions from an RCS file. 


SEE ALSO 

ci(l), co(l), ident(l), merge(l), rcs(l), rcsdiff(l), rcsmerge(l), rlog(l), rcsfile(5). 

Walter F. Tichy, “An Introduction to the Revision Control System”, Programmer Supplemen¬ 
tary Documents, Volume 1 (PSl), #13 
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NAME 

rcsmerge - merge RCS revisions 
SYNOPSIS 

rcsmerge -rrevl ( -r rev2 ] [ -p ] file 
DESCRIPTION 

Rcsmerge incorporates the changes between revl and rev2 of an RCS file into the correspond¬ 
ing working file. If -p is given, the result is printed on the std. output, otherwise the result 
overwrites the working file. 

A file name ending in *,v* is an RCS file name, otherwise a working file name. Merge derives 
the working file name from the RCS file name and vice versa, as explained in co (1). A pair 
consisting of both an RCS and a working file name may also be specified. 

Revl may not be omitted. If rev2 is omitted, the latest revision on the trunk is assumed. 
Both revl and rev2 may be given numerically or symbolically. 

Rcsmerge prints a warning if there are overlaps, and delimits the overlapping regions as 
explained in co -j. The command is useful for incorporating changes into a checked-out revi¬ 
sion. 

EXAMPLES 

Suppose you have released revision 2.8 of f.c. Assume furthermore that you just completed 
revision 3.4, when you receive updates to release 2.8 from someone else. To combine the 
updates to 2.8 and your changes between 2.8 and 3.4, put the updates to 2.8 into file f.c and 
execute 

rcsmerge -p -r2.8 -r3.4 f.c >f.merged.c 

Then examine f.merged.c. Alternatively, if you want to save the updates to 2.8 in the RCS 
file, check them in as revision 2.8.1.1 and execute co -j: 

ci -r2.8.1.1 f.c 
co -r3.4 -j2.8:2.8.1.1 f.c 

As another example, the following command undoes the changes between revision 2.4 and 2.8 
in your currently checked out revision in f.c. 

rcsmerge -r2.8 -r2.4 f.c 

Note the order of the arguments, and that f.c will be overwritten. 

IDENTIFICATION 

Author: Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 

Revision Number: 3.0 ; Release Date: 83/01/15 . 

Copyright ® 1982 by Walter F. Tichy. 

SEE ALSO 

ci (1), co (1), merge (1), ident (1), res (1), resdiff (1), rlog (1), resfile (5). 

Walter F. Tichy, 'Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 
1982. 
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BUGS 

Rcsmerge does not work for files that contain lines with a single V. 
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NAME 

rdist - remote file distribution program 

SYNOPSIS 

rdist [ -nqbRhivwy ] [ -f distfile ] [ -d var=value ] [ -m host ] [ name ... ] 
rdist [ -nqbRhivwy ] -c name ... [login@]host[:dest] 

DESCRIPTION 

Rdist is a program to maintain identical copies of files over multiple hosts. It preserves the 
owner, group, mode, and mtime of files if possible and can update programs that are execut¬ 
ing. Rdist reads commands from distfile to direct the updating of files and/or directories. If 
distfile is the standard input is used. If no —f option is present, the program looks first for 
‘distfile’, then ‘Distfile’ to use as the input. If no names are specified on the command line, 
rdist will update all of the files and directories listed in distfile. Otherwise, the argument is 
taken to be the name of a file to be updated or the label of a command to execute. If label 
and file names conflict, it is assumed to be a label. These may be used together to update 
specific files using specific commands. 

The —c option forces rdist to interpret the remaining arguments as a small distfile. The 
equivalent distfile is as follows. 

( name ... ) - > [login@]host 
install [dest] ; 


Other options: 

—d Define var to have value. The —d option is used to define or override variable 

definitions in the distfile. Value can be the empty string, one name, or a list of names 
surrounded by parentheses and separated by tabs and/or spaces. 

—m Limit which machines are to be updated. Multiple -m arguments can be given to limit 

updates to a subset of the hosts listed the distfile. 

—n Print the commands without executing them. This option is useful for debugging 

distfile. 

—q Quiet mode. Files that are being modified are normally printed on standard output. 

The —q option suppresses this. 

—R Remove extraneous files. If a directory is being updated, any files that exist on the 

remote host that do not exist in the master directory are removed. This is useful for 

maintaining truly identical copies of directories. 

—h Follow symbolic links. Copy the file that the link points to rather than the link itself. 

-i Ignore unresolved links. Rdist will normally try to maintain the link structure of files 

being transferred and warn the user if all the links cannot be found. 

—v Verify that the files are up to date on all the hosts. Any files that are out of date will 

be displayed but no files will be changed nor any mail sent. 

—w Whole mode. The whole file name is appended to the destination directory name. Nor¬ 

mally, only the last component of a name is used when renaming files. This will 
preserve the directory structure of the files being copied instead of flattening the direc¬ 
tory structure. For example, renaming a list of files such as ( dirl/fl dir2/f2 ) to dir3 
would create files dir3/dirl/fl and dir3/dir2/f2 instead of dir3/fl and dir3/f2. 
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—y Younger mode. Files are normally updated if their mtime and size (see stat( 2)) 

disagree. The -y option causes rdist not to update files that are younger than the mas¬ 
ter copy. This can be used to prevent newer copies on other hosts from being 
replaced. A warning message is printed for files which are newer than the master 
copy. 

—b Binary comparison. Perform a binary comparison and update files if they differ rather 

than comparing dates and sizes. 

Distjile contains a sequence of entries that specify the files to be copied, the destination hosts, 
and what operations to perform to do the updating. Each entry has one of the following for¬ 
mats. 


Cvariable name> ‘=’ Cname list> 
label: ] <source list> <destination list> Ccommand list> 

label: <source list> <time_stamp file> <command list> 


The first format is used for defining variables. The second format is used for distributing files 
to other hosts. The third format is used for making lists of files that have been changed since 
some given date. The source list specifies a list of files and/or directories on the local host 
which are to be used as the master copy for distribution. The destination list is the list of 
hosts to which these files are to be copied. Each file in the source list is added to a list of 
changes if the file is out of date on the host which is being updated (second format) or the file 
is newer than the time stamp file (third format). 

Labels are optional. They are used to identify a command for partial updates. 

Newlines, tabs, and blanks are only used as separators and are otherwise ignored. Comments 
begin with and end with a newline. 

Variables to be expanded begin with '$’ followed by one character or a name enclosed in curly 
braces (see the examples at the end). 

The source and destination lists have the following format: 


<name> 

or 

‘(’ <zero or more names separated by w'hite-space> ‘)’ 

The shell meta-characters ‘[’, ']’, ‘{’, *}’, V, and “?’ are recognized and expanded (on the local 
host only) in the same way as csh{ 1). They can be escaped with a backslash. The charac¬ 
ter is also expanded in the same way as csh but is expanded separately on the local and desti¬ 
nation hosts. When the -w option is used with a file name that begins w'ith everything 
except the home directory is appended to the destination name. File names which do not 
begin with */’ or ‘~’ use the destination user’s home directory as the root directory for the rest 
of the file name. 

The command list consists of zero or more commands of the following format. 

‘install’ <options> opt_dest_name 
‘notify’ Cname list>‘;’ 

‘except’ Cname list>‘;’ 

‘except_pat’ C pattern list>‘;’ 

‘special’ Cname list>string ‘;’ 
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The install command is used to copy out of date files and/or directories. Each source file is 
copied to each host in the destination list. Directories are recursively copied in the same way. 
Opt~dest_name is an optional parameter to rename files. If no install command appears in the 
command list or the destination name is not specified, the source file name is used. Direc¬ 
tories in the path name will be created if they do not exist on the remote host. To help 
prevent disasters, a non-empty directory on a target host will never be replaced with a regular 
file or a symbolic link. However, under the ‘-R’ option a non-empty directory will be removed 
if the corresponding filename is completely absent on the master host. The options are ‘-IT, 
‘-h’, ‘-i’, ‘-v’, ‘-w’, *-y’, and ‘-b’ and have the same semantics as options on the command 
line except they only apply to the files in the source list. The login name used on the destina¬ 
tion host is the same as the local host unless the destination name is of the format 
“login @host”. 

The notify command is used to mail the list of files updated (and any errors that may have 
occurred) to the listed names. If no ‘@’ appears in the name, the destination host is 
appended to the name (e.g., namel@host, name2@host, ...). 

The except command is used to update all of the files in the source list except for the files 
listed in name list. This is usually used to copy everything in a directory except certain files. 

The except^pat command is like the except command except that pattern list is a list of regular 
expressions (see ed( 1) for details). If one of the patterns matches some string within a file 
name, that file will be ignored. Note that since ‘\’ is a quote character, it must be doubled to 
become part of the regular expression. Variables are expanded in pattern list but not shell file 
pattern matching characters. To include a '$’, it must be escaped with ‘\’. 

The special command is used to specify sh( 1) commands that are to be executed on the remote 
host after the file in name list is updated or installed. If the name list is omitted then the 
shell commands will be executed for every file updated or installed. The shell variable ‘FILE’ 
is set to the current filename before executing the commands in string. String starts and ends 
with and can cross multiple lines in distfile. Multiple commands to the shell should be 
separated by Commands are executed in the user’s home directory on the host being 
updated. The special command can be used to rebuild private databases, etc. after a pro¬ 
gram has been updated. 

The following is a small example. 

HOSTS = ( matisse root@arpa) 

FILES = ( /bin /lib /usr/bin /usr/games 

/usr/include/{*.h, {stand, sys,vax*, pascal, machine}/*.h} 

/usr/lib /usr/man/man? /usr/ucb /usr/local/rdist ) 

EXLIB = ( Mail.rc aliases aliases.dir aliases.pag crontab dshrc 

sendmail.cf sendmail.fc sendmail.hf sendmail.st uucp vfont ) 

${FILES}-> ${HOSTS} 
install -R ; 

except /usr/lib/${EXLIB} ; 
except /usr/games/lib ; 

special /usr/lib/sendmail ”/usr/lib/sendmail -bz" ; 


srcs: 

/usr/src/bin-> arpa 

except_pat ( \\.o\$ /SCCS\$ ) ; 


ICON INTERNATIONAL 


3 




RDIST(l) 


USER COMMANDS 


RDIST (1) 


IMAGEN = (ips dviimp catdvi) 
imagen: 

/usr/local/${IMAGEN} -> arpa 
install /usr/local/lib ; 
notify ralph ; 

${FILES} :: stamp.cory 

notify root@cory ; 


FILES 

distfile input command file 

/tmp/rdist* temporary file for update lists 

SEE ALSO 

sh(l), csh(l), stat(2) 

DIAGNOSTICS 

A complaint about mismatch of rdist version numbers may really stem from some problem 
with starting your shell, e.g., you are in too many groups. 


BUGS 

Source files must reside on the local host where rdist is executed. 

There is no easy way to have a special command executed after all files in a directory have 
been updated. 

Variable expansion only works for name lists; there should be a general macro facility. 

Rdist aborts on files which have a negative mtime (before Jan 1, 1970). 

There should be a ‘force’ option to allow replacement of non-empty directories by regular files 
or symlinks. A means of updating file modes and owners of otherwise identical files is also 
needed. 
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NAME 

refer - find and insert literature references in documents 


SYNOPSIS 

refer [ -a ] [ —b ] [ — c ] [ —e ] [ —fn ] [ —kx ] [ -lm,n ] [ — n ] [ —p bib ] [ -s keys ] [ — B l.m ] [ 

-P ; ; -S j: file ... ;•. 


DESCRIPTION 

Refer is a preprocessor for nroff or troff[ 1) that finds and formats references for footnotes or 
endnotes. It is also the base for a series of programs designed to index, search, sort, and print 
stand-alone bibliographies, or other data entered in the appropriate form. 

Given an incomplete citation with sufficiently precise keywords, refer will search a biblio¬ 
graphic database for references containing these keywords anywhere in the title, author, jour¬ 
nal, etc. The input file (or standard input) is copied to standard output, except for lines 
between .[ and .] delimiters, which are assumed to contain keywords, and are replaced by 
information from the bibliographic database. The user may also search different databases, 
override particular fields, or add new fields. The reference data, from whatever source, are 
assigned to a set of troff strings. Macro packages such as m$(7) print the finished reference 
text from these strings. By default references are flagged by footnote numbers. 

The following options are available: 

-ar Reverse the first n author names (Jones, J. A. instead of J. A. Jones). If n is omitted 
all author names are reversed. 

-b Bare mode: do not put any flags in text (neither numbers nor labels). 

-c keys 

Capitalize (with CAPS SMALL CAPS) the fields whose key-letters are in keys. 

—e Instead of leaving the references where encountered, accumulate them until a sequence 

of the form 

$LIST$ 

•] 

is encountered, and then write out all references collected so far. Collapse references to 
same source. 

—fn Set the footnote number to n instead of the default of 1 (one). With labels rather than 

numbers, this flag is a no-op. 

-kx Instead of numbering references, use labels as specified in a reference data line begin¬ 
ning %x; by default x is L. 

—1 m,n Instead of numbering references, use labels made from the senior author’s last name 
and the year of publication. Only the first m letters of the last name and the last n 
digits of the date are used. If either m or n is omitted the entire name or date respec¬ 
tively is used. 

—n Do not search the default file /usr/dict/papers/Ind. If there is a REFER environment 

variable, the specified file will be searched instead of the default file; in this case the -n 
flag has no effect. 

—p bib 

Take the next argument bib as a file of references to be searched. The default file is 
searched last. 
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—akeys 

Sort references by fields whose key-letters are in the keys string; permute reference 
numbers in text accordingly. Implies —e. The key-letters in keys may be followed by a 
number to indicate how many such fields are used, with -I- taken as a very large 
number. The default is AD which sorts on the senior author and then date; to sort, 
for example, on all authors and then title use -sA+T. 

—B l.m Bibliography mode. Take a file composed of records separated by blank lines, and turn 
them into troff input. Label / will be turned into the macro .m with / defaulting to 
%X and .m defaulting to AP (annotation paragraph). 

-P Place punctuation marks after the reference signal, rather than before. (Periods 
and commas used to be done with strings.) 

—S Produce references in the Natural or Social Science format. 

To use your own references, put them in the format described below. They can be searched 
more rapidly by running indxbib{l) on them before using refer; failure to index results in a 
linear search. When refer is used with the eqn, neqn or tbl preprocessors refer should be first, 
to minimize the volume of data passed through pipes. 

The refer preprocessor and associated programs expect input from a file of references com¬ 
posed of records separated by blank lines. A record is a set of lines (fields), each containing 
one kind of information. Fields start on a line beginning with a followed by a key- 

letter, then a blank, and finally the contents of the field, and continue until the next line 
starting with The output ordering and formatting of fields is controlled by the macros 

specified for nrofff troff (for footnotes and endnotes) or roffbib (for stand-alone bibliographies). 
For a list of the most common key-letters and their corresponding fields, see addbib(l). An 
example of a refer entry is given below. 

EXAMPLE 

%A M. E. Lesk 

%T Some Applications of Inverted Indexes on the UNIX System 
%B UNIX Programmer’s Manual 
%V 2b 

%\ Bell Laboratories 

%C Murray Hill, NJ 
%D 1978 

FILES 

/usr/dict/papers directory of default publication lists 
/usr/lib/refer directory of companion programs 

SEE ALSO 

addbib(l), sortbib(l), roffbib(l), indxbib(l), lookbib(l) 


AUTHOR 

Mike Lesk 


BUGS 

Blank spaces at the end of lines in bibliography fields will cause the records to sort and 
reverse incorrectly. Sorting large numbers of references causes a core dump. 
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RESET(1) 


USER COMMANDS 


RESET(1) 


NAME 

reset - reset the teletype bits to a sensible state 

SYNOPSIS 

reset 

DESCRIPTION 

Reset sets the terminal to cooked mode, turns off cbreak and raw modes, turns on nl, and 
restores special characters that are undefined to their default values. 

This is most useful after a program dies leaving a terminal in a funny state; you have to type 
“<LF>reset<LF>” to get it to work then to the shell, as <CR> often doesn’t work; often 
none of this will echo. 

It is a good idea to follow reset with tset( 1) 

SEE ALSO 

stty(l), tset(l) 


BUGS 

Doesn’t set tabs properly; it can’t intuit personal choices for interrupt and line kill characters, 
so it leaves these set to the local system standards. 
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REV (1) 


NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of characters in every 
line. If no file is specified, the standard input is copied. 
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USER COMMANDS 


RLOGIN(IC) 


NAME 

rlogin - remote login 

SYNOPSIS 

rlogin rhost [ —e c ] [ -1 username ] 
rhost [ —ec ] [ —1 username ] 

DESCRIPTION 

Rlogin connects your terminal on the current local host system Ihost to the remote host sys¬ 
tem rhost. 

Each host has a file /etc/hosts.equiv which contains a list of rhost’ s with which it shares 
account names. (The host names must be the standard names as described in rsh( 1C).) When 
you rlogin as the same user on an equivalent host, you don’t need to give a password. Each 
user may also have a private equivalence list in a file .rhosts in his login directory. Each line 
in this file should contain a rhost and a username separated by a space, giving additional cases 
where logins without passwords are to be permitted. If the originating user is not equivalent 
to the remote user, then a login and password will be prompted for on the remote machine as 
in login(l). To avoid some security problems, the .rhosts file must be owned by either the 
remote user or root and may not be a symbolic link. 

Your remote terminal type is the same as your local terminal type (as given in your environ¬ 
ment TERM variable). All echoing takes place at the remote site, so that (except for delays) 
the rlogin is transparent. Flow control via *S and 'Q and flushing of input and output on 
interrupts are handled properly. A line of the form disconnects from the remote host, 
where is the escape character. A different escape character may be specified by the -e 
option. There is no space separating this option flag and the argument character. 

SEE ALSO 

rsh(lC) 


FILES 

/usr/hosts/* for rhost version of the command 

BUGS 

More terminal characteristics should be propagated. 
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NAME 

rm, rmdir - remove (unlink) files or directories 

SYNOPSIS 

rm [ —f ] [ —r ] [ —i ] [ — ] file ... 
rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a file requires write permission in its directory, but 
neither read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are 
printed and a line is read from the standard input. If that line begins with ‘y’ the file is 
deleted, otherwise the file remains. No questions are asked and no errors are reported when 
the —f (force) option is given. 

If a designated file is a directory, an error comment is printed unless the optional argument —r 
has been used. In that case, rm recursively deletes the entire contents of the specified direc¬ 
tory, and the directory itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under —r, 
whether to examine each directory. 

The null option — indicates that all the arguments following it are to be treated as file names. 
This allows the specification of file names starting with a minus. 

Rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

rm(l), unlink(2), rmdir(2) 
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USER COMMANDS 


RMAJL(l) 


NAME 

rmail - handle remote mail received via uucp 

SYNOPSIS 

rmail user ... 



DESCRIPTION 

Rmail interprets incoming mail received via uucp( 1C), collapsing “From” lines in the form 
generated by binmail(l) into a single line of the form “return-pathlsender”, and passing the 
processed mail on to sendmail(8). 

Rmail is explicitly designed for use with uucp and sendmail. 

SEE ALSO 

binmail(l), uucp(lC), sendmail(8) 

BUGS 

Rmail should not reside in /bin. 
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RMDIR (1) 


NAME 

rmdir, rm - remove (unlink) directories or files 

SYNOPSIS 

rmdir dir ... 

rm [ -f ] [ -r ] [ -i ] [ - ] file ... 

DESCRIPTION 

Rmdir removes entries for the named directories, which must be empty. 

Rm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a file requires write permission in its directory, but 
neither read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are 
printed and a line is read from the standard input. If that line begins with ‘y’ the file is 
deleted, otherwise the file remains. No questions are asked and no errors are reported when 
the —f (force) option is given. 

If a designated file is a directory, an error comment is printed unless the optional argument -r 
has been used. In that case, rm recursively deletes the entire contents of the specified direc¬ 
tory, and the directory itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under — r, 
whether to examine each directory. 

The null option — indicates that all the arguments following it are to be treated as file names. 
This allows the specification of file names starting with a minus. 

SEE ALSO 

rm(l), unlink(2), rmdir(2) 
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ROFFBIB (1) 


NAME 

roffbib - run off bibliographic database 

SYNOPSIS 

roffbib [ -e ] [ -h ] [ -n ] [ —o ] [ —r ] [ —8 ] [ -T term ] [ -x ] [ -m mac ] [ —V ] [ —Q ] [ file 


DESCRIPTION 

Roffbib prints out all records in a bibliographic database, in bibliography format rather than 
as footnotes or endnotes. Generally it is used in conjunction with sortbib: 

sortbib database | roffbib 

Roffbib accepts most of the options understood by nroff{ 1), most importantly the -T flag to 
specify terminal type. 

If abstracts or comments are entered following the %X field key, roffbib will format them into 
paragraphs for an annotated bibliography. Several %X fields may be given if several annota¬ 
tion paragraphs are desired. The —x flag will suppress the printing of these abstracts. 

A user-defined set of macros may be specified after the —m option. There should be a space 
between the -m and the macro filename. This set of macros will replace the ones defined in 
/usr/lib/tmac/tmac.bib. The -V flag will send output to the Versatec; the -Q flag will 
queue output for the phototypesetter. 

Four command-line registers control formatting style of the bibliography, much like the 
number registers of ms( 7). The command-line argument — rNl will number the references 
starting at one (l). The flag -rV2 will double space the bibliography, while -rVl will double 
space references but single space annotation paragraphs. The line length can be changed from 
the default 6.5 inches to 6 inches with the — rL6i argument, and the page offset can be set 
from the default of 0 to one inch by specifying -rOli (capital O, not zero). Note: with the 
—V and -Q flags the default page offset is already one inch. 

FILES 

/usr/lib/tmac/tmac.bib file of macros used by nroff/troff 

SEE ALSO 

refer(l), addbib(l), sortbib(l), indxbib(l), lookbib(l) 

AUTHORS 

Greg Shenaut, Bill Tuthill 


BUGS 

Users have to rewrite macros to create customized formats. 
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NAME 

rsh - remote shell 

SYNOPSIS 

rsh host [ —1 username ] [ — n ] command 
host [ -1 username ] [ -n ] command 

DESCRIPTION 

Rsh connects to the specified host, and executes the specified command. Rsh copies its stan¬ 
dard input to the remote command, the standard output of the remote command to its stan¬ 
dard output, and the standard error of the remote command to its standard error. Interrupt, 
quit and terminate signals are propagated to the remote command; rsh normally terminates 
when the remote command does. 

The remote username used is the same as your local username, unless you specify a different 
remote name with the -1 option. This remote name must be equivalent (in the sense of 
rlogin( 1C)) to the originating account; no provision is made for specifying a password with a 
command. 

If you omit command, then instead of executing a single command, you will be logged in on 
the remote host using rlogin( 1C). 

Shell metacharacters which are not quoted are interpreted on local machine, while quoted 
metacharacters are interpreted on the remote machine. Thus the command 

rsh otherhost cat remotefile > > localfile 
appends the remote file remotefile to the localfile localfile, while 
rsh otherhost cat remotefile ">>" otherremotefile 
appends remotefile to otherremotefile. 

Host names are given in the file /etc/hosts. Each host has one standard name (the first name 
given in the file), which is rather long and unambiguous, and optionally one or more nick¬ 
names. The host names for local machines are also commands in the directory /usr/hosts: if 
you put this directory in your search path then the rsh can be omitted. 


FILES 

/etc/hosts 

/usr/hosts/* 

SEE ALSO 

rlogin(lC) 


BUGS 

If you are using csA(l) and put a rsh(lC) in the background without redirecting its input 
away from the terminal, it will block even if no reads are posted by the remote command. If 
no input is desired you should redirect the input of rsh to /dev/null using the —n option. 

You cannot run an interactive command (like rogue( 6) or vi(l)); use rlogin(lC). 

Stop signals stop the local rsh process only; this is arguably wrong, but currently hard to fix 
for reasons too complicated to explain here. 
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USER COMMANDS 


RUPTIME (1C) 


NAME 

ruptime - show host status of local machines 

SYNOPSIS 

ruptime [ — a ] [ —1 ] [ -t ] [ —u ] 

DESCRIPTION 

Ruptime gives a status line like uptime for each machine on the local network; these are 
formed from packets broadcast by each host on the network once a minute. 

Machines for which no status report has been received for 5 minutes are shown as being down. 
Users idle an hour or more are not counted unless the -a flag is given. 

Normally, the listing is sorted by host name. The -1 , -t , and -u flags specify sorting by 
load average, uptime, and number of users, respectively. 


FILES 

/usr/spool/rwho/whod.* data files 

SEE ALSO 

rwho(lC) 
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NAME 

rwho - who’s logged in on local machines 

SYNOPSIS 

rwho [ -a ] 

DESCRIPTION 

The rwho command produces output similar to who, but for all machines on the local net¬ 
work. If no report has been received from a machine for 5 minutes then rwho assumes the 
machine is down, and does not report users last known to be logged into that machine. 

If a users hasn’t typed to the system for a minute or more, then rwho reports this idle time. 
If a user hasn’t typed to the system for an hour or more, then the user will be omitted from 
the output of rwho unless the -a flag is given. 


FILES 

/usr/spool/rwho/whod.* information about other machines 

SEE ALSO 

ruptime(lC), rwhod(8C) 

BUGS 

This is unwieldy when the number of machines on the local net is large. 
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MAINTENANCE COMMANDS 


SCCSTORCS (8) 


NAME 

sccstorcs - build RCS file from SCCS file 

SYNOPSIS 

sccstorcs [—t] [—v] s.file ... 

DESCRIPTION 

Sccstorcs builds an RCS file from each SCCS file argument. The deltas and comments for 
each delta are preserved and installed into the new RCS file in order. Also preserved are the 
user access list and descriptive text, if any, from the SCCS file. 

The following flags are meaningful: 

—t Trace only. Prints detailed information about the SCCS file and lists the commands 

that would be executed to produce the RCS file. No commands are actually executed 
and no RCS file is made. 

—v Verbose. Prints each command that is run while it is building the RCS file. 

FILES 

For each s.somefile, Sccstorcs writes the files somefile and $omefile,v which should not already 
exist. Sccstorcs will abort, rather than overwrite those files if they do exist. 

SEE ALSO 

ci (1), co (1), res (1). 

Walter F. Tichy, ’Design, Implementation, and Evaluation of a Revision Control System," in 
Proceedings of the 6th International Conference on Software Engineering , IEEE, Tokyo, Sept. 
1982. 

DIAGNOSTICS 

All diagnostics are written to stderr. Non-zero exit status on error. 


BUGS 

Sccstorcs does not preserve all SCCS options specified in the SCCS file. Most notably, it does 
not preserve removed deltas, MR numbers, and cutoff points. 


AUTHOR 

Ken Greer 

Copyright ® 1983 by Kenneth L. Greer 
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SCRIPT (1) 


NAME 

script - make typescript of terminal session 

SYNOPSIS 

script [ — a ] [ file ] 

DESCRIPTION 

Script makes a typescript of everything printed on your terminal. The typescript is written to 
file, or appended to file if the -a option is given. It can be sent to the line printer later with 
Ipr. If no file name is given, the typescript is saved in the file typescript. 

The script ends when the forked shell exits. 

This program is useful when using a crt and a hard-copy record of the dialog is desired, as for 
a student handing in a program that was developed on a crt when hard-copy terminals are in 
short supply. 


BUGS 

Script places everything in the log file. This is not what the naive user expects. 
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SED (1) 


NAME 

sed - stream editor 

SYNOPSIS 

sed [ — n ] [ — e script ] [ —f sfile ] [ file ] ... 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according 
to a script of commands. The —f option causes the script to be taken from file sfile; these 
options accumulate. If there is just one -e option and no —f’s, the flag -e may be omitted. 
The -n option suppresses the default output. 

A script consists of editing commands, one per line, of the following form: 

[address [, address] ] function [arguments] 

In normal operation sed cyclically copies a line of input into a pattern space (unless there is 
something left after a ‘D’ command), applies in sequence all commands whose addresses select 
that pattern space, and at the end of the script copies the pattern space to the standard out¬ 
put (except under —n) and deletes the pattern space. 

An address is either a decimal number that counts input lines cumulatively across files, a *$’ 
that addresses the last line of input, or a context address, ‘/regular expression/’, in the style 
of ed( 1) modified thus: 

The escape sequence ‘\n’ matches a newline embedded in the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A command line with two addresses selects the inclusive range from the first pattern space 
that matches the first address through the next pattern space that matches the second. (If 
the second address is a number less than or equal to the line number first selected, only one 
line is selected.) Thereafter the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation 
function “!’ (below). 

In the following list of functions the maximum number of permissible addresses for each func¬ 
tion is indicated in parentheses. 

An argument denoted text consists of one or more lines, all but the last of which end with ‘\’ 
to hide the newline. Backslashes in text are treated like backslashes in the replacement string 
of an ‘s’ command, and may be used to protect initial blanks and tabs against the stripping 
that is done on every script line. 

An argument denoted rfile or wfile must terminate the command line and must be preceded 
by exactly one blank. Each wfile is created before processing begins. There can be at most 10 
distinct wfile arguments. 

(1) A 

text 

Append. Place text on the output before reading the next input line. 

(2) b label 

Branch to the ‘:’ command bearing the label. If label is empty, branch to the end of 
the script. 


ICON INTERNATIONAL 


1 



USER COMMANDS 


SED (1) 


SED(1) 

(2)c\ 
text 

Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address 
range, place text on the output. Start the next cycle. 

(2) d Delete the pattern space. Start the next cycle. 

(2) D Delete the initial segment of the pattern space through the first newline. Start the 
next cycle. 

(2) g Replace the contents of the pattern space by the contents of the hold space. 

(2) G Append the contents of the hold space to the pattern space. 

(2) h Replace the contents of the hold space by the contents of the pattern space. 

(2) H Append the contents of the pattern space to the hold space. 

(1) i\ 

text 

Insert. Place text on the standard output. 

(2) n Copy the pattern space to the standard output. Replace the pattern space with the 

next line of input. 

(2)N Append the next line of input to the pattern space with an embedded newline. (The 
current line number changes.) 

(2)p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first newline to the standard 
output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2) r rfile 

Read the contents of rfile. Place them on the output before reading the next input 
line. 

(2) s/ regular expressionjreplacement/flags 

Substitute the replacement string for instances of the regular expression in the pattern 
space. Any character may be used instead of */\ For a fuller description see ed( 1). 
Flags is zero or more of 

g Global. Substitute for all nonoverlapping instances of the regular expression 
rather than just the first one. 

p Print the pattern space if a replacement was made. 

w wfile 

Write. Append the pattern space to wfile if a replacement was made. 

(2) t label 

Test. Branch to the command bearing the label if any substitutions have been 
made since the most recent reading of an input line or execution of a ‘t\ If label is 
empty, branch to the end of the script. 

(2) w wfile 

Write. Append the pattern space to wfile. 

(2) x Exchange the contents of the pattern and hold spaces. 

(2) y / stringl / strings/ 

Transform. Replace all occurrences of characters in stringl with the corresponding 
character in string2. The lengths of stringl and strings must be equal. 
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(2)! function 

Don’t, Apply the function (or group, if function is ‘{’) only to lines not selected by the 
address(es). 


(0): label 

This command does nothing; it bears a label for ‘b’ and ‘t’ commands to branch to. 

(1) = Place the current line number on the standard output as a line. 

(2) { Execute the following commands through a matching *}’ only when the pattern space 

is selected. 


(0) An empty command is ignored. 


SEE ALSO 

ed(l), grep(l), awk(l), lex(l) 
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NAME 

sendbug - mail a system bug report to 4bsd-bugs 

SYNOPSIS 

sendbug [ address ] 

DESCRIPTION 

Bug reports sent to ‘4bsd-bugs@BERKELEY’ are intercepted by a program which expects 
bug reports to conform to a standard format. Sendbug is a shell script to help the user com¬ 
pose and mail bug reports in the correct format. Sendbug works by invoking tn'(l) on a tem¬ 
porary copy of the bug report format outline. The user must fill in the appropriate fields and 
exit vi. Sendbug then mails the completed report to ‘4bsd-bugs@BERKELEY’ or the address 
specified on the command line. 


FILES 

/usr/ucb/bugformat contains the bug report outline 

SEE ALSO 

vi(l), sendmail(8) 
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SFDATE (1) 


NAME 

sfdate - set the time/date of a file 



SYNOPSIS 

sfdate yymmddhhmm [ .ss ] file ... 

DESCRIPTION 

The "accessed" and "updated" times for the specified files are set to the specified date, yy is 
the last two digits of the year; the first mm is the month number; dd is the day number in the 
month; hh is the hour number (24 hour system); the second mm is the minute number; .ss is 
optional and is the seconds. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The year, month and day may be omitted, the current 
values being the defaults. 


EXAMPLE 

To set all the files in the directory hierarchy "dir" to midnight on April 1st, 1986: 
find dir -exec sfdate 8604010000 {} \; 
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NAME 

sh, for, case, if, while, :, ., break, continue, cd, eval, exec, exit, export, login, read, readonly, 
set, shift, times, trap, umask, wait - command language 

SYNOPSIS 

sh [ —ceiknrstuvx ] [ arg ] ... 

DESCRIPTION 

Sh is a command programming language that executes commands read from a terminal or a 
file. See invocation for the meaning of arguments to the shell. 

Commands. 

A simple-command is a sequence of non blank words separated by blanks (a blank is a tab or 
a space). The first word specifies the name of the command to be executed. Except as 
specified below the remaining words are passed as arguments to the invoked command. The 
command name is passed as argument 0 (see execve(2)). The value of a simple-command is its 
exit status if it terminates normally or 200+sta£us if it terminates abnormally (see sigvec( 2) 
for a list of status values). 

A pipeline is a sequence of one or more commands separated by |. The standard output of 
each command but the last is connected by a pipe{ 2) to the standard input of the next com¬ 
mand. Each command is run as a separate process; the shell waits for the last command to 
terminate. 

A list is a sequence of one or more pipelines separated by ;, &, && or || and optionally ter¬ 
minated by ; or &. ; and & have equal precedence which is lower than that of && and 11, 
&& and || also have equal precedence. A semicolon causes sequential execution; an amper¬ 
sand causes the preceding pipeline to be executed without waiting for it to finish. The symbol 
&& (II) causes the list following to be executed only if the preceding pipeline returns a zero 
(non zero) value. Newlines may appear in a list, instead of semicolons, to delimit commands. 

A command is either a simple-comm and or one of the following. The value returned by a 
command is that of the last simple-command executed in the command. 

for name [in word ... ] do list done 

Each time a for command is executed name is set to the next word in the for word 
list If in word ... is omitted, in "$@" is assumed. Execution ends when there are no 
more words in the list. 

case word in [pattern [ | pattern ] ... ) list ;;] ... esac 

A case command executes the list associated with the first pattern that matches word. 
The form of the patterns is the same as that used for file name generation. 

if list then list [elif list then list ] ... [else list ] fi 

The list following if is executed and if it returns zero the list following then is exe¬ 
cuted. Otherwise, the list following elif is executed and if its value is zero the list fol¬ 
lowing then is executed. Failing that the else list is executed. 

while list [ do list ] done 

A while command repeatedly executes the while list and if its value is zero executes 
the do list; otherwise the loop terminates. The value returned by a while command is 
that of the last executed command in the do list, until may be used in place of while 
to negate the loop termination test. 

( list ) Execute list in a subshell. 

{ list } list is simply executed. 
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The following words are only recognized as the first word of a command and when not f 
quoted. V 

if then else elif fi ease in esac for while until do done { } 

Command substitution. 

The standard output from a command enclosed in a pair of back quotes ('') may be used as 
part or all of a word; trailing newlines are removed. 

Parameter substitution. 

The character $ is used to introduce substitutable parameters. Positional parameters may be 
assigned values by set. Variables may be set by writing 

name—value [ name=value ] ... 

$ {parameter } 

A parameter is a sequence of letters, digits or underscores (a name), a digit, or any of 
the characters * @ # ? — $ !. The value, if any, of the parameter is substituted. The 
braces are required only when parameter is followed by a letter, digit, or underscore 
that is not to be interpreted as part of its name. If parameter is a digit, it is a posi¬ 
tional parameter. If parameter is * or @ then all the positional parameters, starting 
with $1, are substituted separated by spaces. $0 is set from argument zero when the 
shell is invoked. 

$ { parameter-word } 

If parameter is set, substitute its value; otherwise substitute word. 

$ {parameter = word} 

If parameter is not set, set it to word; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

$ {parameter ? word } 

If parameter is set, substitute its value; otherwise, print word and exit from the shell. 

If word is omitted, a standard message is printed. 

$ {parameter 4- word } 

If parameter is set, substitute word; otherwise substitute nothing. 

In the above word is not evaluated unless it is to be used as the substituted string. (So that, 
for example, echo ${d- pwd'} will only execute pwd if d is unset.) 

The following parameters are automatically set by the shell. 

# The number of positional parameters in decimal. 

- Options supplied to the shell on invocation or by set. 

? The value returned by the last executed command in decimal. 

$ The process number of this shell. 

! The process number of the last background command invoked. 

The following parameters are used but not set by the shell. 

HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see execution). 

MAIL If this variable is set to the name of a mail file, the shell informs the user of the 
arrival of mail in the specified file. 

PSl Primary prompt string, by default ’$ ’. 

PS2 Secondary prompt string, by default ’> ’. 

IFS Internal field separators, normally space, tab, and newline. 

Blank interpretation. 

After parameter and command substitution, any results of substitution are scanned for inter¬ 
nal field separator characters (those found in $DFS) and split into distinct arguments where ■ 
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such characters are found. Explicit null arguments (”" or ") are retained. Implicit null argu¬ 
ments (those resulting from parameters that have no values) are removed. 

File name generation. 

Following substitution, each command word is scanned for the characters *, ? and [. If one of 
these characters appears, the word is regarded as a pattern. The word is replaced with alpha¬ 
betically sorted file names that match the pattern. If no file name is found that matches the 
pattern, the word is left unchanged. The character . at the start of a file name or immedi¬ 
ately following a /, and the character /, must be matched explicitly. 

* Matches any string, including the null string, 
r Matches any single character. 

[...] Matches any one of the characters enclosed. A pair of characters separated by - 
matches any character lexically between the pair. 

Quoting. 

The following characters have a special meaning to the shell and cause termination of a word 
unless quoted. 

; & ( ) | < > newline space tab 

A character may be quoted by preceding it with a \. \newline is ignored. All characters 
enclosed between a pair of quote marks (' '), except a single quote, are quoted. Inside double 
quotes ("") parameter and command substitution occurs and \ quotes the characters \ ' " and 
$. 

"$*" is equivalent to ”$l $2 ...” whereas 
"$@" is equivalent to "$l" "$2".... 

Prompting. 

When used interactively, the shell prompts with the value of PSi before reading a command. 
If at any time a newline is typed and further input is needed to complete a command, the 
secondary prompt ($PS2) is issued. 

Input output. 

Before a command is executed its input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-command or may 
precede or follow a command and are not passed on to the invoked command. Substitution 
occurs before word or digit is used. 

< word 

Use file word as standard input (file descriptor 0). 

> word 

Use file word as standard output (file descriptor 1). If the file does not exist, it is 
created; otherwise it is truncated to zero length. 

> > word 

Use file word as standard output. If the file exists, output is appended (by seeking to 
the end); otherwise the file is created. 

<< word 

The shell input is read up to a line the same as word 1 or end of file. The resulting 
document becomes the standard input. If any character of word is quoted, no 
interpretation is placed upon the characters of the document; otherwise, parameter 
and command substitution occurs, \newline is ignored, and \ is used to quote the 
characters \ $ ' and the first character of word. 

< & digit 

The standard input is duplicated from file descriptor digit; see dup( 2). Similarly for 
the standard output using > . 
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< &- The standard input is closed. Similarly for the standard output using > . 

If one of the above is preceded by a digit, the file descriptor created is that specified by the 
digit (instead of the default 0 or 1). For example, 

... 2>&1 

creates file descriptor 2 to be a duplicate of file descriptor I. 

If a command is followed by & then the default standard input for the command is the 
empty file (/dev/null). Otherwise, the environment for the execution of a command contains 
the file descriptors of the invoking shell as modified by input output specifications. 

Environment. 

The environment is a list of name-value pairs that is passed to an executed program in the 
same way as a normal argument list; see execve(2) and envtron( 7). The shell interacts with 
the environment in several ways. On invocation, the shell scans the environment and creates 
a parameter for each name found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the values of these parameters or creates 
new ones, none of these affects the environment unless the export command is used to bind 
the shell’s parameter to the environment. The environment seen by any executed command is 
thus composed of any unmodified name-value pairs originally inherited by the shell, plus any 
modifications or additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more 
assignments to parameters. Thus these two lines are equivalent 

TERM=450 cmd args 

(export TERM; TERM=450; cmd args) 

If the —k flag is set, all keyword arguments are placed in the environment, even if the occur 

after the command name. The following prints ’a==b c’ and V: 

echo a=b c 

set -k 

echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is 
followed by &; otherwise signals have the values inherited by the shell from its parent. (But 
see also trap.) 

Execution. 

Each time a command is executed the above substitutions are carried out. Except for the 
’special commands’ listed below a new process is created and an attempt is made to execute 
the command via an execve(2). 

The shell parameter SPATH defines the search path for the directory containing the command. 
Each alternative directory name is separated by a colon (:). The default path is 
:/bin:/usr/bin. If the command name contains a /, the search path is not used. Otherwise, 
each directory in the path is searched for an executable file. If the file has execute permission 
but is not an a.out file, it is assumed to be a file containing shell commands. A subshell (i.e., 
a separate process) is spawned to read it. A parenthesized command is also executed in a sub¬ 
shell. 

Special commands. 

The following commands are executed in the shell process and except where specified no input 
output redirection is permitted for such commands. 

: No effect; the command does nothing. 

. file Read and execute commands from file and return. The search path SPATH is used to 
find the directory containing file. 
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break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified, break n levels. 

continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is specified, resume 
at the n-th enclosing loop, 
cd [ arg} 

Change the current directory to arg. The shell parameter SHOME is the default arg . 
eval [ arg...] 

The arguments are read as input to the shell and the resulting command(s) executed, 
exec [ arg ... } 

The command specified by the arguments is executed in place of this shell without 
creating a new process. Input output arguments may appear and if no other argu¬ 
ments are given cause the shell input output to be modified, 
exit [ n ] 

Causes a non interactive shell to exit with the exit status specified by n. If n is omit¬ 
ted, the exit status is that of the last command executed. (An end of file will also exit 
from the shell.) 
export [ name ... ] 

The given names are marked for automatic export to the environment of 
subsequently-executed commands. If no arguments are given, a list of exportable 
names is printed, 
login [arg ... ] 

Equivalent to ’exec login arg ...’. 
read name ... 

One line is read from the standard input; successive words of the input are assigned to 
the variables name in order, with leftover words to the last variable. The return code 
is 0 unless the end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these names may not be 
changed by subsequent assignment. If no arguments are given, a list of all readonly 
names is printed, 
set [— eknptuvx [ arg ... ] ] 

-~e If non interactive, exit immediately if a command fails. 

— k All keyword arguments are placed in the environment for a command, not just 
those that precede the command name. 

—n Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

—v Print shell input lines as they are read. 

—x Print commands and their arguments as they are executed. 

— Turn off the — x and -v options. 

These flags can also be used upon invocation of the shell. The current set of flags may 
be found in $-. 

Remaining arguments are positional parameters and are assigned, in order, to $1, $2, 
etc. If no arguments are given, the values of all names are printed. 

shift The positional parameters from $2... are renamed $i... 

times Print the accumulated user and system times for processes run from the shell, 
trap [ arg] [ n] ... 

Arg is a command to be read and executed when the shell receives signal(s) n. (Note 
that arg is scanned once when the trap is set and once when the trap is taken.) Trap 
commands are executed in order of signal number. If arg is absent, all trap(s) n are 
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reset to their original values. If arg is the null string, this signal is ignored by the shell 
and by invoked commands. If n is 0, the command arg is executed on exit from the 
shell, otherwise upon receipt of signal n as numbered in sigvec( 2). Trap with no argu¬ 
ments prints a list of commands associated with each signal number. 

umask [ nnn ] 

The user file creation mask is set to the octal value nnn (see umask( 2)). If nnn is omit¬ 
ted, the current value of the mask is printed. 

wait [ n ] 

Wait for the specified process and report its termination status. If n is not given, all 
currently active child processes are waited for. The return code from this command is 
that of the process waited for. 

Invocation. 

If the first character of argument zero is commands are read from $HOME/. profile, if such 
a file exists. Commands are then read as described below. The following flags are interpreted 
by the shell when it is invoked. 

—c string If the —c flag is present, commands are read from string. 

— s If the — s flag is present or if no arguments remain then commands are read from 

the standard input. Shell output is written to file descriptor 2. 

— i If the -i flag is present or if the shell input and output are attached to a terminal 

(as told by gtty) then this shell is interactive. In this case the terminate signal 
SIGTERM (see sigvec{ 2)) is ignored (so that ’kill O’ does not kill an interactive 
shell) and the interrupt signal SIGINT is caught and ignored (so that wait is 
interruptible). In all cases SIGQUIT is ignored by the shell. 

The remaining flags and arguments are described under the set command. 


FILES 

$HOME/. profile 
/tmp/sh* 

/dev/null 

SEE ALSO 

csh(l), test(l), execve(2), environ(7) 


DIAGNOSTICS 

Errors detected by the shell, such as syntax errors cause the shell to return a non zero exit 
status. If the shell is being used non interactively then execution of the shell file is aban¬ 
doned. Otherwise, the shell returns the exit status of the last command executed (see also 
exit). 


BUGS 

If << is used to provide standard input to an asynchronous process invoked by &, the shell 
gets mixed up about naming the input document. A garbage file /tmp/sh* is created, and the 
shell complains about not being able to find the file by another name. 
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NAME 

size - size of an object file 

SYNOPSIS 

size [ object ... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, and bss portions, and 
their sum in hex and decimal, of each object-file argument. If no file is specified, a.out is 
used. 

SEE ALSO 

a.out(5) 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain 
amount of time as in: 

(sleep 105; command)#; 
or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 


SEE ALSO 

setitimer(2), alarm(3C), sleep(3) 


BUGS 

Time must be less than 2,147,483,647 seconds. 
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NAME 

soelim - eliminate .so’s from nroff input 

SYNOPSIS 

soelim [ file ... ] 

DESCRIPTION 

Soelim reads the specified files or the standard input and performs the textual inclusion 
implied by the nroff directives of the form 

.so somefile 

when they appear at the beginning of input lines. This is useful since programs such as tbl do 
not normally do this; it allows the placement of individual tables in separate files to be run as 
a part of a large document. 

An argument consisting of a single minus (-) is taken to be a file name corresponding to the 
standard input. 

Note that inclusion can be suppressed by using ‘ ° instead of i.e. 

so /usr/lib/tmac.s 
A sample usage of soelim would be 

soelim exum?.n | tbl | nroff -ms | col | lpr 


SEE ALSO 

colcrt(l), more(l) 

AUTHOR 

William Joy 

BUGS 

The format of the source commands must involve no strangeness - exactly one blank must 
precede and no blanks follow the file name. 
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NAME 

sort - sort or merge files 

SYNOPSIS 

sort [ — mubdfinrtz ] [ +posl [ -pos2 ] ] ... [ — o name ] [ -T directory ] [ name ] ... 
DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output. 
The name means the standard input. If no input files are named, the standard input is 
sorted. 

The default sort key is an entire line. Default ordering is lexicographic by bytes in machine 
collating sequence. The ordering is affected globally by the following options, one or more of 
which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons, 
d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons, 
f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is sorted by arithmetic value. Option n implies 
option b. 

r Reverse the sense of comparisons. 
tx ‘Tab character’ separating fields is x. 

The notation +posl —pos2 restricts a sort key to a field beginning at posl and ending just 
before pos2. Posl and pos2 each have the form m.n, optionally followed by one or more of 
the flags bdfinr, where m tells a number of fields to skip from the beginning of the line and n 
tells a number of characters to skip further. If any flags are present they override all the glo¬ 
bal ordering options for this key. If the b option is in effect n is counted from the first non¬ 
blank in the field; b is attached independently to pos2. A missing .n means .0; a missing 
—pos2 means the end of the line. Under the —tx option, fields are strings separated by x] oth¬ 
erwise fields are nonempty nonblank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; give no output unless 
the file is out of sort. 

m Merge only, the input files are already sorted. 

o The next argument is the name of an output file to use instead of the standard output. 
This file may be the same as one of the inputs. 

T The next argument is the name of a directory in which temporary files should be made. 

u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do 

not participate in this comparison. 
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EXAMPLES 

Print in alphabetical order all the unique spellings in a list of words. Capitalized words differ 
from uncapitalized. 

sort -u +0f +0 list 

Print the password file (passwd( 5)) sorted by user id number (the 3rd colon-separated field), 
sort -t: +2n /etc/passwd 

Print the first instance of each month in an already sorted file of (month day) entries. The 
options —um with just one input file make the choice of a unique representative from a set of 
equal lines predictable. 

sort -um +0 -1 dates 


FILES 

/usr/tmp/stm*, /tmp/* first and second tries for temporary files 
SEE ALSO 


uniq(l), comm(l), rev(l), join(l) 


DIAGNOSTICS 

Comments and exits with nonzero status for various trouble conditions and for disorder 
discovered under option —c. 

BUGS 

Very long lines are silently truncated. 
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NAME 

sortbib - sort bibliographic database 

SYNOPSIS 

sortbib [ -sKEYS ] database ... 

DESCRIPTION 

Sortbib sorts files of records containing refer key-letters by user-specified keys. Records may 
be separated by blank lines, or by .[ and .] delimiters, but the two styles may not be mixed 
together. This program reads through each database and pulls out key fields, which are sorted 
separately. The sorted key fields contain the file pointer, byte offset, and length of 
corresponding records. These records are delivered using disk seeks and reads, so sortbib may 
not be used in a pipeline to read standard input. 

By default, sortbib alphabetizes by the first %A and the %D fields, which contain the senior 
author and date. The —s option is used to specify new KEYS. For instance, —sATD will sort 
by author, title, and date, while -sA+D will sort by all authors, and date. Sort keys past the 
fourth are not meaningful. No more than 16 databases may be sorted together at one time. 
Records longer than 4096 characters will be truncated. 

Sortbib sorts on the last word on the %A line, which is assumed to be the author’s last name. 
A word in the final position, such as “jr.” or “ed.”, will be ignored if the name beforehand 
ends with a comma. Authors with two-word last names or unusual constructions can be 
sorted correctly by using the nroff convention “\0” in place of a blank. A %Q field is con¬ 
sidered to be the same as %A, except sorting begins with the first, not the last, word. Sortbib 
sorts on the last word of the %D line, usually the year. It also ignores leading articles (like 
“A” or “The”) when sorting by titles in the %T or %J fields; it will ignore articles of any 
modern European language. If a sort-significant field is absent from a record, sortbib places 
that record before other records containing that field. 

SEE ALSO 

refer(l), addbib(l), roffbib(l), indxbib(l), lookbib(l) 

AUTHORS 

Greg Shenaut, Bill Tuthill 


BUGS 

Records with missing author fields should probably be sorted by title. 
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NAME 

spell, spellin, spellout - find spelling errors 

SYNOPSIS 

spell [ -v ] [ -b ] [ —x ] [ —d hlist ] [ -s hstop ] [ -h spellhist ] [ file ] ... 
spellin [ list ] 
spellout [ -d ] list 

DESCRIPTION 

Spell collects words from the named documents, and looks them up in a spelling list. Words 
that neither occur among nor are derivable (by applying certain inflections, prefixes or 
suffixes) from words in the spelling list are printed on the standard output. If no files are 
named, words are collected from the standard input. 

Spell ignores most troff, tbl and eqn( 1) constructions. 

Under the —v option, all words not literally in the spelling list are printed, and plausible 
derivations from spelling list words are indicated. 

Under the —b option, British spelling is checked. Besides preferring centre, colour, speciality, 
travelled, etc., this option insists upon -ise in words like standardise, Fowler and the OED to 
the contrary notwithstanding. 

Under the -x option, every plausible stem is printed with '=’ for each word. 

The spelling list is based on many sources. While it is more haphazard than an ordinary dic¬ 
tionary, it is also more effective with proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine and chemistry is light. 

The auxiliary files used for the spelling list, stop list, and history file may be specified by 
arguments following the —d, -s, and —h options. The default files are indicated below. 
Copies of all output may be accumulated in the history file. The stop list filters out misspel¬ 
lings (e.g. thier=thy-y+ier) that would otherwise pass. 

Two routines help maintain the hash lists used by spell. Both expect a set of words, one per 
line, from the standard input. Spellin combines the words from the standard input and the 
preexisting list file and places a new list on the standard output. If no list file is specified, the 
new list is created from scratch. Spellout looks up each word from the standard input and 
prints on the standard output those that are missing from (or present on, with option —d) the 
hashed list file. For example, to verify that hookey is not on the default spelling list, add it to 
your own private list, and then use it with spell , 

echo hookey I spellout /usr/dict/hlista 

echo hookey | spellin /usr/dict/hlista > myhlist 

spell -d myhlist huckfinn 


FILES 

/ usr / diet/hlist [ab] 
/usr/dict/hstop 
/dev/null 
/tmp/spell.$$* 
/usr/lib/spell 


hashed spelling lists, American & British, default for —d 
hashed stop list, default for —s 
history file, default for —h 
temporary files 
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SEE ALSO 

deroff(l), sort(l), tee(l), sed(l) 


BUGS 

The spelling list’s coverage is uneven; new installations will probably wish to monitor the out¬ 
put for several months to gather local additions. 

British spelling was done by an American. 
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NAME 

spline - interpolate smooth curve 

SYNOPSIS 

spline [ option ] ... 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abcissas and ordinates of a function. 
It produces a similar set, which is approximately equally spaced and includes the input set, on 
the standard output. The cubic spline output (R. W. Hamming, Numerical Methods for 
Scientists and Engineers, 2nd ed., 349ff) has two continuous derivatives, and sufficiently many 
points to look smooth when plotted, for example by graph(lG). 

The following options are recognized, each as a separate argument. 

-a Supply abscissas automatically (they are missing from the input); spacing is given by 
the next argument, or is assumed to be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation 

«&' = **i', ft' = W -1 

is set by the next argument. By default k = 0. 

-n Space output points so that approximately n intervals occur between the lower and 
upper x limits. (Default n = 100.) 

-p Make output periodic, i.e. match derivatives at ends. First and last input values should 
normally agree. 

—x Next 1 (or 2) arguments are lower (and upper) x limits. Normally these limits are calcu¬ 
lated from the data. Automatic abcissas start at lower limit (default 0). 


SEE ALSO 

graph(lG), plot(lG) 


DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input without interpolating 
extra points. 


BUGS 

A limit of 1000 input points is enforced silently. 
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NAME 

split - split a file into pieces 

SYNOPSIS 

split [ — n ] [ file [ name ] ] 

DESCRIPTION 

Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto a set of 
output files. The name of the first output file is name with aa appended, and so on lexico¬ 
graphically. If no output name is given, x is default. 

If no input file is given, or if - is given in its stead, then the standard input file is used. 
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NAME 

strip - remove symbols and relocation bits 

SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to the output of the 
assembler and loader. This is useful to save space after a program has been debugged. 

The effect of strip is the same as use of the —s option of Id. 


FILES 

/tmp/stm? temporary file 

SEE ALSO 
ld(l) 
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NAME 

strings - find tbe printable strings in a object, or other binary, file 
SYNOPSIS 

strings [ — ] [ — o ] [ —number ] file ... 

DESCRIPTION 

Strings looks for ascii strings in a binary file. A string is any sequence of 4 or more printing 
characters ending with a newline or a null. Unless the — flag is given, strings only looks in the 
initialized data space of object files. If the -o flag is given, then each string is preceded by its 
offset in the file (in octal). If the —number flag is given then number is used as the minimum 
string length rather than 4. 

Strings is useful for identifying random object files and many other things. 

SEE ALSO 

od(l') 

BUGS 

The algorithm for identifying strings is extremely primitive 
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NAME 

struct - structure Fortran programs 

SYNOPSIS 

struct [ option ] ... file 

DESCRIPTION 

Struct translates the Fortran program specified by file (standard input default) into a Ratfor 
program. Wherever possible, Ratfor control constructs replace the original Fortran. State¬ 
ment numbers appear only where still necessary. Cosmetic changes are made, including 
changing Hollerith strings into quoted strings and relational operators into symbols (.e.g. 
”.GT." into ">"). The output is appropriately indented. 

The following options may occur in any order. 

-s Input is accepted in standard format, i.e. comments are specified by a c, C, or * in 
column 1, and continuation lines are specified by a nonzero, nonblank character in 
column 6. Normally input is in the form accepted by f7 7(1) 

—i Do not turn computed goto statements into switches. (Ratfor does not turn switches 
back into computed goto statements.) 

—a Turn sequences of else ifs into a non-Ratfor switch of the form 
switch 

{ case predl: code 
case pred2: code 
case pred3: code 
default: code 

} 

The case predicates are tested in order; the code appropriate to only one case is exe¬ 
cuted. This generalized form of switch statement does not occur in Ratfor. 

—b Generate goto’s instead of multilevel break statements. 

—n Generate goto’s instead of multilevel next statements. 

—tn Make the nonzero integer n the lowest valued label in the output program (default 10). 
—cn Increment successive labels in the output program by the nonzero integer n (default 1). 

—en If n is 0 (default), place code within a loop only if it can lead to an iteration of the 

loop. If n is nonzero, admit a small code segments to a loop if otherwise the loop 

w r ould have exits to several places including the segment, and the segment can be 
reached only from the loop. ‘Small’ is close to, but not equal to, the number of state¬ 
ments in the code segment. Values of n under 10 are suggested. 

FILES 

/tmp/struct* 

/usr/lib / struct / * 

SEE ALSO 

177(1) 
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BUGS 

Struct knows Fortran 66 syntax, but not full Fortran 77. 

If an input Fortran program contains identifiers which are reserved words in Ratfor, the 
structured version of the program will not be a valid Ratfor program. 

The labels generated cannot go above 32767. 

If you get a goto without a target, try -e . 


f \ 
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NAME 

stty - set terminal options 

SYNOPSIS 

stty [ option ... ] 


DESCRIPTION 

Stty sets certain I/O options on the current output terminal, placing its output on the diag¬ 
nostic output. With no argument, it reports the speed of the terminal and the settings of the 
options which are different from their defaults. With the argument “all”, all normally used 
option settings are reported. With the argument “everything”, everything stty knows about 
is printed. The option strings are selected from the following set: 

even allow even parity input 

—even disallow even parity input 

odd allow odd parity input 

-odd disallow odd parity input 

raw raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed 

back) 

—raw negate raw mode 

cooked same as ‘-raw’ 

cbreak make each character available to read( 2) as received; no erase and kill processing, 
but all other processing (interrupt, suspend, ...) is performed 
—cbreak make characters available to read only when newline is received 
—nl allow carriage return for new-line, and output CR-LF for carriage return or new- 

line 

nl accept only new-line to end lines 

echo echo back every character typed 

—echo do not echo characters 

lease map upper case to lower case 

—lease do not map case 

tandem enable flow control, so that the system sends out the stop character when its inter¬ 
nal queue is in danger of overflowing on input, and sends the start character when 
it is ready to accept further input 
—tandem disable flow control 

hh enable hardware handshaking, so that the system handshakes with RTS/CTS 

hardware protocol 

-hh disable hardware handshaking 

-tabs replace tabs by spaces when printing 

tabs preserve tabs 

ek set erase and kill characters to # and @ 

For the following commands which take a character argument c, you may also specify c as the 
“u” or “undef”, to set the value to be undefined. A value of “"x”, a 2 character sequence, is 
also interpreted as a control character, with “*?” representing delete. 

erase c set erase character to c (default but often reset to 'H.) 

kill c set kill character to c (default ‘@’, but often reset to *U.) 

intr c set interrupt character to c (default DEL or '? (delete), but often reset to 'C.) 

quit c set quit character to c (default control \.) 

start c set start character to c (default control Q.) 

stop c set stop character to c (default control S.) 

eof c set end of file character to c (default control D.) 
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brk c set break character to c (default undefined.) This character is an extra wakeup 
causing character. 

crO crl cr2 cr3 

select style of delay for carriage return (see ioctl{ 2)) 
nlO nil nl2 nl3 

select style of delay for linefeed 
tabO tabl tab2 tab3 

select style of delay for tab 
£PD fifl select style of delay for form feed 

bsO bsl select style of delay for backspace 

tty33 set all modes suitable for the Teletype Corporation Model 33 terminal. 

tty37 set all modes suitable for the Teletype Corporation Model 37 terminal. 

vt05 set all modes suitable for Digital Equipment Corp. VT05 terminal 

dec set all modes suitable for Digital Equipment Corp. operating systems users; (erase, 

kill, and interrupt characters to "?, "U, and *C, decctlq and “newcrt”.) . 

tn300 set all modes suitable for a General Electric TermiNet 300 

ti700 set all modes suitable for Texas Instruments 700 series terminal 

tek set all modes suitable for Tektronix 4014 terminal 

0 hang up phone line immediately 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb rs422 

Set terminal baud rate to the number given, if possible. 

A teletype driver which supports the job control processing of csh(l) and more functionality 
than the basic driver is fully described in tty(4). The following options apply only to it. 

new Use new driver (switching flushes typeahead). 

crt Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) 

crtbs Echo backspaces on erase characters. 

prterase For printing terminal echo erased characters backwards within “\” and “/”. 
crterase Wipe out erased characters with “backspace-space-backspace.” 

—crterase Leave erased characters visible; just backspace, 
crtkill Wipe out input on like kill ala crterase. 

—crtkill Just echo line kill character and a newline on line kill. 

ctlecho Echo control characters as “~x” (and delete as Print two backspaces follow¬ 

ing the EOT character (control D). 

—ctlecho Control characters echo as themselves; in cooked mode EOT (control-D) is not 
echoed. 

decctlq 

—decctlq 

tostop 
—tostop 
tilde 
—tilde 
flusho 
—flusho 
pendin 

—pend in 
intrup 


After output is suspended (normally by A S), only a start character (normally 'Q) 
will restart it. This is compatible with DEC’s vendor supplied systems. 

After output is suspended, any character typed will restart it; the start character 
will restart output without providing any input. (This is the default.) 

Background jobs stop if they attempt terminal output. 

Output from background jobs to the terminal is allowed. 

Convert to on output (for Hazeltine terminals). 

Leave poor alone. 

Output is being discarded usually because user hit control O (internal state bit). 
Output is not being discarded. 

Input is pending after a switch from cbreak to cooked and will be reinput when a 
read becomes pending or more input arrives (internal state bit). 

Input is not pending. 

Send a signal (SIGTINT) to the terminal control process group whenever an input 
record (line in cooked mode, character in cbreak or raw mode) is available for 
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reading. 

—intrup Don’t send input available interrupts. 

mdmbuf Start/stop output on carrier transitions (not implemented). 

—mdmbuf 


litout 
—litout 
nohang 
—nohang 
etxack 


Return error if write attempted after carrier drops. 

Send output characters without any processing. 

Do normal output processing, inserting delays, etc. 

Don’t send hangup signal if carrier drops. 

Send hangup signal to control process group when carrier drops. 
Diablo style etx/ack handshaking (not implemented). 


The following special characters are applicable only to the new teletype driver and are not 
normally changed. 

susp c set suspend process character to c (default control Z). 

dsusp c set delayed suspend process character to c (default control Y). 

rprnt c set reprint line character to c (default control R). 

flush c set flush output character to c (default control O). 

werase c set word erase character to c (default control W). 

lnext c set literal next character to c (default control V). 


SEE ALSO 

ioctl(2), tabs(l), tset(l), tty(4) 
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NAME 

style - analyze surface characteristics of a document 

SYNOPSIS 

style [ -ml ] [ -mm ] [ —a. ] [ —e ] [ —1 num ] [ -r num ] [ -p ] [ -P ] file ... 

DESCRIPTION 

Style analyzes the surface characteristics of the writing style of a document. It reports on rea¬ 
dability, sentence length and structure, word length and usage, verb type, and sentence 
openers. Because style runs deroff before looking at the text, formatting header files should be 
included as part of the input. The default macro package -ms may be overridden with the 
flag -mm. The flag —ml, which causes deroff to skip lists, should be used if the document 
contains many lists of non-sentences. The other options are used to locate sentences with cer¬ 
tain characteristics. 

—a print all sentences with their length and readability index. 

—e print all sentences that begin with an expletive. 

—p print all sentences that contain a passive verb. 

—lnum print all sentences longer than num. 

—mum print all sentences whose readability index is greater than num. 

-P print parts of speech of the words in the document. 

SEE ALSO 

deroff(l), diction(l) 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. 
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NAME 

su - substitute user id temporarily 

SYNOPSIS 

su [ userid ] 

DESCRIPTION 

Su demands the password of the specified userid, and if it is given, changes to that userid and 
invokes the Shell sh(l) without changing the current directory. The user environment is 
unchanged except for HOME and SHELL, which are taken from the password file for the user 
being substituted (see environ( 7)). The new user ID stays in force until the Shell exits. 

If no userid is specified, ‘root’ is assumed. To remind the super-user of his responsibilities, the 
Shell substitutes for its usual prompt. 

SEE ALSO 

sh(l) 


BUGS 

Local administrative rules cause restrictions to be placed on who can su to ‘root’, even with 
the root password. These rules vary from site to site. 
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NAME 

sum - sum and count blocks in a file 

SYNOPSIS 

sum file 


DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of 
blocks in the file. It is typically used to look for bad spots, or to validate a file communicated 
over some transmission line. 


SEE ALSO 
wc(l) 

DIAGNOSTICS 

‘Read error’ is indistinguishable from end of file on most devices; check the block count. 
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NAME 

symorder - rearrange name list 

SYNOPSIS 

symorder orderlist symbolfile 
DESCRIPTION 

Orderlist is a file containing symbols to be found in symbolfile, 1 symbol per line. 

Symbolfile is updated in place to put the requested symbols first in the symbol table, in the 
order specified. This is done by swapping the old symbols in the required spots with the new 
ones. If all of the order symbols are not found, an error is generated. 

This program was specifically designed to cut down on the overhead of getting symbols from 
/vmunix. 

SEE ALSO 

nlist(3) 
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NAME 

sysline - display system status on status line of a terminal 

SYNOPSIS 

sysline [ —bcdehDilmpqrsj ] [ -H remote ] [ +N ] 

DESCRIPTION 

Sysline runs in the background and periodically displays system status information on the 
status line of the terminal. Not all terminals contain a status line. Those that do include the 
hl9, concept 108, Ann Arbor Ambassador, vtlOO, Televideo 925/950 and Freedom 100. If no 
flags are given, sysline displays the time of day, the current load average, the change in load 
average in the last 5 minutes, the number of users (followed by a ‘u’), the number of runnable 
process, the number of suspended processes, and the users who have logged on and off since 
the last status report. Finally, if new mail has arrived, a summary of it is printed. If there is 
unread mail in your mailbox, an asterisk will appear after the display of the number of users. 
The display is normally in reverse video (if your terminal supports this in the status line) and 
is right justified to reduce distraction. Every fifth display is done in normal video to give the 
screen a chance to rest. 

If you have a file named .who in your home directory, then the contents of that file is printed 
first. One common use of this feature is to alias chdir, pushd, and popd to place the current 
directory stack in ~/.who after it changes the new directory. 

The following flags may be given on the command line. 

— b Beep once every half hour and twice every hour, just like those obnoxious 

watches you keep hearing. 

—c Clear the status line for 5 seconds before each redisplay. 

— d Debug mode — print status line data in human readable format 

—D Print out the current day/date before the time. 

—e Print out only the information. Do not print out the control commands neces¬ 

sary to put the information on the bottom line. This option is useful for put¬ 
ting the output of sysline onto the mode line of an emacs window. 

-H remote Print the load average on the remote host remote . If the host is down, or is not 
sending out rwhod packets, then the down time is printed instead. 

-h Print out the host machine’s name after the time. 

—1 Don’t print the names of people who log in and out. 

—m Don’t check for mail. 

—p Don’t report the number of process which are runnable and suspended. 

-r Don’t display in reverse video. 

-f N Update the status line every N seconds. The default is 60 seconds. 

—q Don’t print out diagnostic messages if something goes wrong when starting up. 

— i Print out the process id of the sysline process onto standard output upon 

startup. With this information you can send the alarm signal to the sysline pro¬ 
cess to cause it to update immediately, sysline writes to the standard error, so 
you can redirect the standard output into a file to catch the process id. 
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—s Print "short" form of line by left-justifying iff escapes are not allowed in the 

status line. Some terminals (the Televideos and Freedom 100 for example) do 
not allow cursor movement (or other "intelligent" operations) in the status line. 
For these terminals, sysline normally uses blanks to cause right-justification. 
This flag will disable the adding of the blanks. 

—j Force the sysline output to be left justified even on terminals capable of cursor 

movement on the status line. 

If you have a file .syslinelock in your home directory, then sysline will not update its statistics 
and write on your screen, it will just go to sleep for a minute. This is useful if you want to 
momentarily disable sysline. Note that it may take a few seconds from the time the lock file is 
created until you are guaranteed that sysline will not write on the screen. 


FILES 

/etc/utmp 

/dev/kmem 

/ usr/spool/rwho/whod. * 
${HOME}/.who 
${HOME }/ .sy sli n elock 


names of people who are logged in 
contains process table 
who/uptime information for remote hosts 
information to print on bottom line 
when it exists, sysline will not print 


AUTHORS 

John Foderaro 

Tom Ferrin converted it to use term cap. 
Mark Horton added terminfo capability. 


BUGS 

If you interrupt the display then you may find your cursor missing or stuck on the status 
line. The best thing to do is reset the terminal. 

If there is too much for one line, the excess is thrown away. 
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NAME 

tabs - set terminal tabs 

SYNOPSIS 

tabs [ -n ] [ terminal ] 

DESCRIPTION 

Tabs sets the tabs on a variety of terminals. Various terminal names given in term( 7) are 
recognized; the default is, however, suitable for most 300 baud terminals. If the -n flag is 
present then the left margin is not indented as is normal. 

SEE ALSO 

stty(l), term(7) 


BUGS 

It’s much better to use <se*(l). 
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NAME 

tac - concatenate and print files in reverse order 
SYNOPSIS 

tac [ —string ] [ +string ] [ file ... ] 

DESCRIPTION 

Tac reads each file in sequence and writes it on the standard output, reversed by the file seg¬ 
ments delimited by string, -string specifies segments bounded on the left by string, while 
+string specifies right-bounded segments. The default is +\n (print lines in reverse order). If 
no input file is given, or if the argument is encountered, tac reads from the standard input. 
Note that in this case tac stores the entire standard input in a temporary file before it outputs 
anything, so for large input it is slow. 

EXAMPLES 

tac ’-\ 

From ’ /usr/spool/mail/$USER 
prints out one’s mail messages, most recent first. 

tac file 

prints the file in reverse, line by line. 

tac /usr/adm/messages | egrep ’hp.*hard’ 
prints out the hard errors on MXSSBUS disk drives, most recent first. 

SEE ALSO 

cat(l), rev(l), tail(l), tmail(l) 


BUGS 

Tac doesn’t handle multiple argument files exactly right, and it is unclear in which order they 
should be processed. 

If invoked as ‘tac < file’, tac uses a temp file but it doesn’t have to. 
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NAME 

tail - deliver the last part of a file 
SYNOPSIS 

tail [ ±number [lbc][fr] ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is 
named, the standard input is used. 

Copying begins at distance +number from the beginning, or -number from the end of the 
input. Number is counted in units of lines, blocks or characters, according to the appended 
option 1, b or c. When no units are specified, counting is by lines. 

Specifying r causes tail to print lines from the end of the file in reverse order. The default for 
r is to print the entire file this way. Specifying f causes tail to not quit at end of file, but 
rather wait and try to read repeatedly in hopes that the file will grow. 

SEE ALSO 

ddw 


BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. 
Various kinds of anomalous behavior may happen with character special files. 
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NAME 

talk - talk to another user 

SYNOPSIS 

talk person [ tty name ] 

DESCRIPTION 

Talk is a visual communication program which copies lines from your terminal to that of 
another user. 

If you wish to talk to someone on you own machine, then person is just the person’s login 
name. If you wish to talk to a user on another host, then person is of the form : 

host/user or 
host.user or 
host:user or 
user@host 

though host@user is perhaps preferred. 

If you want to talk to a user who is logged in more than once, the ttyname argument may be 
used to indicate the appropriate terminal name. 

When first called, it sends the message 

Message from TalkDaemon@his_machine... 

talk: connection requested by your_name@your_machine. 

talk: respond with: talk your_name@your_machine 

to the user you wish to talk to. At this point, the recipient of the message should reply by 
typing 

talk your_name@your_machine 

It doesn’t matter from which machine the recipient replies, as long as his login-name is the 
same. Once communication is established, the two parties may type simultaneously, with 
their output appearing in separate windows. Typing control L will cause the screen to be 
reprinted, w'hile your erase, kill, and word kill characters will work in talk as normal. To exit, 
just type your interrupt character; talk then moves the cursor to the bottom of the screen and 
restores the terminal. 

Permission to talk may be denied or granted by use of the mesg command. At the outset 
talking is allowed. Certain commands, in particular nroff and pr( 1) disallow messages in 
order to prevent messy output. 

FILES 

/etc/hosts to find the recipient’s machine 
/etc/utmp to find the recipient’s tty 


SEE ALSO 

mesg(l), who(l), mail(l), write(l) 
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NAME 

tar - tape archiver 

SYNOPSIS 

tar [ key ] [ name ... ] 

DESCRIPTION 

Tar saves and restores multiple files on a single file (usually a magnetic tape, but it can be 
any file). Tar’s actions are controlled by the key argument. The key is a string of characters 
containing at most one function letter and possibly one or more function modifiers. Other 
arguments to tar are file or directory names specifying which files to dump or restore. In all 
cases, appearance of a directory name refers to the files and (recursively) subdirectories of that 
directory. 

The function portion of the key is specified by one of the following letters: 
r The named files are written on the end of the tape. The c function implies this. 

x The named files are extracted from the tape. If the named file matches a directory 

whose contents had been written onto the tape, this directory is (recursively) 
extracted. The owner, modification time, and mode are restored (if possible). If no 
file argument is given, the entire content of the tape is extracted. Note that if multi¬ 
ple entries specifying the same file are on the tape, the last one overwrites all earlier. 

t The names of the specified files are listed each time they occur on the tape. If no file 

argument is given, all of the names on the tape are listed. 

u The named files are added to the tape if either they are not already there or have 

been modified since last put on the tape. 

c Create a new tape; writing begins on the beginning of the tape instead of after the 

last file. This command implies r. 

o On output, tar normally places information specifying owner and modes of direc¬ 

tories in the archive. Former versions of tar, when encountering this information 
will give error message of the form 
"<name>/: cannot create". 

This option will suppress the directory information. 

p This option says to restore files to their original modes, ignoring the present 

umask(2). Setuid and sticky information will also be restored to the super-user. 

The following characters may be used in addition to the letter which selects the function 
desired. 

0 , 9 This modifier selects an alternate drive on which the tape is mounted. The default 

is drive 0 at 1600 bpi, which is normally /dev/rmt8. 

v Normally tar does its work silently. The v (verbose) option make tar type the 

name of each file it treats preceded by the function letter. With the t function, 
the verbose option gives more information about the tape entries than just their 
names. 

w Tar prints the action to be taken followed by file name, then wait for user 

confirmation. If a word beginning with ‘y’ is given, the action is done. Any other 
input means don’t do it. 

f Tar uses the next argument as the name of the archive instead of /dev/rmt?. If 

the name of the file is tar writes to standard output or reads from standard 
input, whichever is appropriate. Thus, tar can be used as the head or tail of a filter 
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chain. Tar can also be used to move hierarchies with the command 
cd fromdir; tar cf - . | (cd todir; tar xf -) 

b Tar uses the next argument as the blocking factor for tape records. The default is 

20 (the maximum). This option should only be used with raw magnetic tape 
archives (See f above). The block size is determined automatically when reading 
tapes (key letters ‘x’ and ‘t’). 

1 tells tar to complain if it cannot resolve all of the links to the files dumped. If this 

is not specified, no error messages are printed. 

m tells tar not to restore the modification times. The modification time will be the 

time of extraction. 

h Force tar to follow symbolic links as if they were normal files or directories. Nor¬ 

mally, tar does not follow symbolic links. 

B Forces input and output blocking to 20 blocks per record. This option was added 

so that tar can work across a communications channel where the blocking may not 
be maintained. 

If a file name is preceded by —C, then tar will perform a chdir(2 ) to that file name. This 
allows multiple directories not related by a close common parent to be archived using short 
relative path names. For example, to archive files from /usr/include and from /etc, one might 
use 

tar c -C /usr include -C / etc 

Previous restrictions dealing with far’s inability to properly handle blocked archives have been 
lifted. 

FILES 

/dev/rmt? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 

Complaints if enough memory is not available to hold the link tables. 


BUGS 

There is no way to ask for the n-th occurrence of a file. 
Tape errors are handled ungracefully. 

The u option can be slow. 

The current limit on file name length is 100 characters. 
There is no way to selectively follow symbolic links. 
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NAME ( 

tb! - format tables for nroff or troff - 


SYNOPSIS 

tbl [ files ] ... 

DESCRIPTION 

Tbl is a preprocessor for formatting tables for nroff or troff[ 1). The input files are copied to 
the standard output, except for lines between and are reformatted. Details are given in the 
tbl(l) reference manual. x 

EXAMPLE 

As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 

.TS 

css 

CCS 

c c c 
1 n n. 

Household Population 

Town\tHouseholds 

\tNumber\tSize 

Bedminster\t789\t3.26 

Bernards Twp.\t3087\t3.74 

Ber n ar dsv ille\t2018\t3.30 

Bound Brook\t3425\t3.04 

Branchburg\tl644\t3.49 

Bridgewater\t7897\t3.81 

Far Hills\t240\t3.19 

.TE 

yields 


Household Population 
Town Households 



Number 

Size 

Bed minster 

789 

3.26 

Bernards Twp. 

3087 

3.74 

Bernardsville 

2018 

3.30 

Bound Brook 

3425 

3.04 

Branchburg 

1644 

3.49 

Bridgewater 

7897 

3.81 

Far Hills 

240 

3.19 


If no arguments are given, tbl reads the standard input, so it may be used as a filter. When 
tbl is used with eqn or neqn the tbl command should be first, to minimize the volume of data 
passed through pipes. 

SEE ALSO 

troff(l), eqn(l) 

M. E. Lesk, TBL. 
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NAME 

tc - photoypesetter simulator 

SYNOPSIS 

tc [ -t ] [ -sN ] [ —pL ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device codes for a Graphic Systems photo¬ 
typesetter (cat). The standard output of tc is intended for a Tektronix 4015 (a 4014 terminal 
with ASCII and APL character sets). The sixteen typesetter sizes are mapped into the 4014’s 
four sizes; the entire TROFF character set is drawn using the 4014’s character generator, 
using overstruck combinations where necessary. Typical usage: 

troff -t file | tc 

At the end of each page tc waits for a newline (empty line) from the keyboard before continu¬ 
ing on to the next page. In this wait state, the command e will suppress the screen erase 
before the next page; sN will cause the next N pages to be skipped; and lline will send line to 
the shell. 

The command line options are: 

—t Don’t wait between pages; for directing output into a file. 

-sN Skip the first N pages. 

-pL Set page length to L. L may include the scale factors p (points), i (inches), c (centime¬ 
ters), and P (picas); default is picas. 

'—I w' Multiply the default aspect ratio, 1.5, of a displayed page by //u?. 

SEE ALSO 

troff(l), plot(lG) 


BUGS 

Font distinctions are lost. 

tc’s character set is limited to ASCII in just one size. 
The aspect ratio option is unbelievable. 
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NAME /"'N 

tcopy - copy a mag tape 

SYNOPSIS 

tcopy arc [ dest ] 

DESCRIPTION 

Tcopy is designed to copy magnetic tapes. The only assumption made about the tape is that 
there are two tape marks at the end. Tcopy with only a source tape specified will print infor¬ 
mation about the sizes of records and tape files. If a destination is specified, then, a copy will 
be made of the source tape. The blocking on the destination tape will be identical to that 
used on the source tape. Copying a tape will yield the same output as if just printing the 
sizes. 

SEE ALSO 

mtio(4) 


,r~' - 
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NAME 

TEACHJOVE - learn how to use the JOVE editor 


SYNOPSIS 

teachjove 

DESCRIPTION 

TEACHJOVE is a simple program that calls up the JOVE editor on a special file that is an 
interactive tutorial for the JOVE editor. Once in JOVE all you do is follow the instructions 
and by doing so you will learn all about JOVE! 


FILES 

/usr/new/lib/jove/teach-jove — THE special file. 

SEE ALSO 

JOVE(l) - to learn about JOVE in general. 

AUTHOR 

Jonathan Payne 
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NAME 

tee - pipe fitting 

SYNOPSIS 

tee [ —i ] [ —a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes copies in the files. 
Option — i ignores interrupts; option -a causes the output to be appended to the files rather 
than overwriting them. 
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NAME 

telnet - user interface to the TELNET protocol 

SYNOPSIS 

telnet [ host [ port ] ] 

DESCRIPTION 

Telnet is used to communicate with another host using the TELNET protocol. If telnet is 
invoked without arguments, it enters command mode, indicated by its prompt (“telnet>”). 
In this mode, it accepts and executes the commands listed below. If it is invoked with argu¬ 
ments, it performs an open command (see below) with those arguments. 

Once a connection has been opened, telnet enters input mode. In this mode, text typed is sent 
to the remote host. To issue telnet commands when in input mode, precede them with the 
telnet “escape character” (initially “"[”). When in command mode, the normal terminal edit¬ 
ing conventions are available. 

The following commands are available. Only enough of each command to uniquely identify it 
need be typed. 

open host [ port ] 

Open a connection to the named host. If the no port number is specified, telnet will 
attempt to contact a TELNET server at the default port. The host specification may 
be either a host name (see hosts( 5)) or an Internet address specified in the “dot nota¬ 
tion”. 

close Close a TELNET session and return to command mode, 
quit Close any open TELNET session and exit telnet. 

i Suspend telnet. This command only works when the user is using the cs/i(l). 
escape [ escape-char ] 

Set the telnet “escape character”. Control characters may be specified as “'” followed 
by a single letter; e.g. “control-X” is “"X”. 

status Show the current status of telnet. This includes the peer one is connected to, as well 
as the state of debugging. 

options 

Toggle viewing of TELNET options processing. When options viewing is enabled, all 
TELNET option negotiations will be displayed. Options sent by telnet are displayed 
as “SENT”, while options received from the TELNET server are displayed as 
“RCVD”. 

crmod 

Toggle carriage return mode. When this mode is enabled any carriage return charac¬ 
ters received from the remote host will be mapped into a carriage return and a line 
feed. This mode does not affect those characters typed by the user, only those 
received. This mode is not very useful, but is required for some hosts that like to ask 
the user to do local echoing. 

? [ command ] 

Get help. With no arguments, telnet prints a help summary. If a command is 
specified, telnet will print the help information available about the command only. 

BUGS 

This implementation is very simple because rlogin( 1C) is the standard mechanism used to 
communicate locally with hosts. 
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NAME 

test - condition command 


SYNOPSIS 

test expr 

DESCRIPTION 

test evaluates the expression expr, and if its value is true then returns zero exit status; other¬ 
wise, a non zero exit status is returned, test returns a non zero exit if there are no arguments. 

The following primitives are used to construct expr. 

—r file true if the file exists and is readable. 

—w file true if the file exists and is writable. 

—f file true if the file exists and is not a directory. 

—d file true if the file exists exists and is a directory. 

—s file true if the file exists and has a size greater than zero. 

—t [ fildes ] 

true if the open file whose file descriptor number is fildes (1 by default) is associated 
with a terminal device. 

—z si true if the length of string si is zero. 

—n si true if the length of the string si is nonzero, 

si = s2 true if the strings si and s2 are equal, 

si != s2 true if the strings si and s2 are not equal, 

si true if si is not the null string, 

nl —eq n2 

true if the integers nl and n2 are algebraically equal. Any of the comparisons -ne, 
-gt, -ge, -It, or -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! unary negation operator 

—a binary and operator 
—o binary or operator 
( expr ) 

parentheses for grouping. 

—a has higher precedence than —o. Notice that all the operators and flags are separate argu¬ 
ments to test. Notice also that parentheses are meaningful to the Shell and must be escaped. 

SEE ALSO 

sh(l), find(l) 
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NAME 

tftp - trivial file transfer program 

SYNOPSIS 

tftp [ host ] 

DESCRIPTION 

Tftp is the user interface to the Internet TFTP (Trivial File Transfer Protocol), which allows 
users to transfer files to and from a remote machine. The remote host may be specified on the 
command line, in which case tftp uses host as the default host for future transfers (see the 
connect command below). 

COMMANDS 

Once tftp is running, it issues the prompt tftp> and recognizes the following commands: 
connect host-name [ port ] 

Set the host (and optionally port ) for transfers. Note that the TFTP protocol, unlike 
the FTP protocol, does not maintain connections betweeen transfers; thus, the connect 
command does not actually create a connection, but merely remembers what host is to 
be used for transfers. You do not have to use the connect command; the remote host 
can be specified as part of the get or put commands. 

mode transfer-mode 

Set the mode for transfers; transfer-mode may be one of ascii or binary. The default is 
ascii. 

put file 

put localfile remotefile 

put filel fileS ... fileN remote-directory 

Put a file or set of files to the specified remote file or directory. The destination can be 
in one of two forms: a filename on the remote host, if the host has already been 
specified, or a string of the form host.filename to specify both a host and filename at 
the same time. If the latter form is used, the hostname specified becomes the default 
for future transfers. If the remote-directory form is used, the remote host is assumed 
to be a UNIX machine. 

get filename 

get remotename localname 
get filel fileS ... fileN 

Get a file or set of files from the specified sources. Source can be in one of two forms: 
a filename on the remote host, if the host has already been specified, or a string of the 
form host.filename to specify both a host and filename at the same time. If the latter 
form is used, the last hostname specified becomes the default for future transfers. 

quit Exit tftp. An end of file also exits. 

verbose 

Toggle verbose mode. 

trace Toggle packet tracing. 

status Show current status. 

rexmt retransmission-timeout 

Set the per-packet retransmission timeout, in seconds. 

timeout total-transmission-timeout 

Set the total transmission timeout, in seconds. 
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ascii Shorthand for "mode ascii” 
binary 

Shorthand for "mode binary" 

? [ command-name ... ] 

Print help information. 


v_ 


BUGS 

Because there is no user-login or validation within the TFTP protocol, the remote site will 
probably have some sort of file-access restrictions in place. The exact methods are specific to 
each site and therefore difficult to document here. 
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NAME 

time - time a command 

SYNOPSIS 

time command 


DESCRIPTION 

The given command is executed; after it is complete, time prints the elapsed time during the 
command, the time spent in the system, and the time spent in execution of the command. 
Times are reported in seconds. 

The times are printed on the diagnostic output stream. 

Time is built in to csh( 1), using a different output format. 

BUGS 

Elapsed time is accurate to the second, while the CPU times are measured to the 100th 
second. Thus the sum of the CPU times can be up to a second larger than the elapsed time. 

Time is a built-in command to csh( 1), with a much different syntax. This command is avail¬ 
able as “/bin/time” to csh users. 
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NAME 

tip, cu - connect to a remote system 

SYNOPSIS 

tip [ —v ] [ —speed j system-name 
tip -v ] [ —speed ) phone-number 

cu phone-number [ —t ] [ —s speed } [ -a acu ] [ -1 line ] [ —# ] 

DESCRIPTION 

Tip and cu establish a full-duplex connection to another machine, giving the appearance of 
being logged in directly on the remote cpu. It goes without saying that you must have a login 
on the machine (or equivalent) to which you wish to connect. The preferred interface is tip. 
The cu interface is included for those people attached to the “call UNIX” command of version 
7. This manual page describes only tip. 

Typed characters are normally transmitted directly to the remote machine (which does the 
echoing as well). A tilde (‘“’) appearing as the first character of a line is an escape signal; the 
following are recognized: 

~"D Drop the connection and exit (you may still be logged in on the remote machine). 

~c [name] Change directory to name (no argument implies change to your home directory). 

~! Escape to a shell (exiting the shell will return you to tip). 

~> Copy file from local to remote. Tip prompts for the name of a local file to 

transmit. 

~ < Copy file from remote to local. Tip prompts first for the name of the file to be 

sent, then for a command to be executed on the remote machine. 

~p from [ to ] 

Send a file to a remote UNIX host. The put command causes the remote UNIX 
system to run the command string “cat > ’to”’, while tip sends it the “from” file. 
If the “to” file isn’t specified the “from” file name is used. This command is actu¬ 
ally a UNIX specific version of the command. 

~t from [ to } 

Take a file from a remote UNIX host. As in the put command the “to” file 
defaults to the “from” file name if it isn’t specified. The remote host executes the 
command string “cat ’from’jecho "A” to send the file to tip. 

~ | Pipe the output from a remote command to a local UNIX process. The command 

string sent to the local UNIX system is processed by the shell. 

Send a BREAK to the remote system. For systems which don’t support the neces¬ 
sary ioctl call the break is simulated by a sequence of line speed changes and DEL 
characters. 

~s Set a variable (see the discussion below). 

~ ~Z Stop tip (only available with job control). 

Get a summary of the tilde escapes 

Tip uses the file /etc/remote to find how to reach a particular system and to find out how it 
should operate while talking to the system; refer to remote( 5) for a full description. Each sys¬ 
tem has a default baud rate with which to establish a connection. If this value is not suitable, 
the baud rate to be used may be specified on the command line, e.g. “tip -300 mds”. 
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When tip establishes a connection it sends out a connection message to the remote system; the 
default value, if any, is defined in /etc/remote. 

When tip prompts for an argument (e.g. during setup of a file transfer) the line typed may be 
edited with the standard erase and kill characters. A null line in response to a prompt, or an 
interrupt, will abort the dialogue and return you to the remote machine. 

Tip guards against multiple users connecting to a remote system by opening modems and ter¬ 
minal lines with exclusive access, and by honoring the locking protocol used by uucp(lC). 

During file transfers tip provides a running count of the number of lines transferred. When 
using the ~> and ~< commands, the “eofread” and “eofwrite” variables are used to recog¬ 
nize end-of-file when reading, and specify end-of-file when writing (see below). File transfers 
normally depend on tandem mode for flow control. If the remote system does not support 
tandem mode, “echocheck” may be set to indicate tip should synchronize with the remote sys¬ 
tem on the echo of each transmitted character. 

When tip must dial a phone number to connect to a system it will print various messages 
indicating its actions. Tip supports the DEC DN-11 and Racal-Vadic 831 auto-call-units; the 
DEC DF02 and DF03, Ventel 212+, Racal-Vadic 3451, and Bizcomp 1031 and 1032 integral 
call unit/modems. 

VARIABLES 

Tip maintains a set of variables which control its operation. Some of these variable are read¬ 
only to normal users (root is allowed to change anything of interest). Variables may be 
displayed and set through the “s” escape. The syntax for variables is patterned after w(l) 
and Mail[ 1). Supplying “all” as an argument to the set command displays all variables read¬ 
able by the user. Alternatively, the user may request display of a particular variable by 
attaching a “?’ to the end. For example “escape?” displays the current escape character. 

Variables are numeric, string, character, or boolean values. Boolean variables are set merely 
by specifying their name; they may be reset by prepending a T to the name. Other variable 
types are set by concatenating an ‘=’ and the value. The entire assignment must not have 
any blanks in it. A single set command may be used to interrogate as well as set a number of 
variables. Variables may be initialized at run time by placing set commands (without the 
“~s” prefix in a file .tiprc in one’s home directory). The —v option causes tip to display the 
sets as they are made. Certain common variables have abbreviations. The following is a list 
of common variables, their abbreviations, and their default values. 

beautify 

(bool) Discard unprintable characters when a session is being scripted; abbreviated be. 

baud rate 

(num) The baud rate at which the connection was established; abbreviated ba. 

dialtimeout 

(num) When dialing a phone number, the time (in seconds) to wait for a connection to 
be established; abbreviated dial. 

echocheck 

(bool) Synchronize with the remote host during file transfer by waiting for the echo of 
the last character transmitted; default is off. 

eofread 

(str) The set of characters which signify and end-of-tranmission during a ~< file 
transfer command; abbreviated eofr. 

eofwrite 

(str) The string sent to indicate end-of-transmission during a ~> file transfer com¬ 
mand; abbreviated eofw. 
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eol 

(str) The set of characters which indicate an end-of-line. Tip will recognize escape 
characters only after an end-of-line. 

escape 

(char) The command prefix (escape) character; abbreviated es; default value is ‘~\ 

exceptions 

(str) The set of characters which should not be discarded due to the beautification 
switch; abbreviated ex; default value is “\t\n\f\b”. 

force 

(char) The character used to force literal data transmission; abbreviated fo; default 
value is ‘*P\ 

framesize 

(num) The amount of data (in bytes) to buffer between file system writes when receiv¬ 
ing files; abbreviated fr. 

host 

(str) The name of the host to which you are connected; abbreviated ho. 

prompt 

(char) The character w'hich indicates and end-of-line on the remote host; abbreviated 
pr; default value is ‘\n’. This value is used to synchronize during data transfers. The 
count of lines transferred during a file transfer command is based on recipt of this 
character. 

raise 

(bool) Upper case mapping mode; abbreviated ra; default value is off. When this 
mode is enabled, all lower case letters will be mapped to upper case by tip for 
transmission to the remote machine. 

raisechar 

(char) The input character used to toggle upper case mapping mode; abbreviated rc; 
default value is ‘"A*. 

record 

(str) The name of the file in which a session script is recorded; abbreviated rec; default 
value is “tip.record”. 

script 

(bool) Session scripting mode; abbreviated sc; default is off. When script is true, tip 
will record everything transmitted by the remote machine in the script record file 
specified in record. If the beautify switch is on, only printable ASCII characters will be 
included in the script file (those characters betwee 040 and 0177). The variable excep¬ 
tions is used to indicate characters which are an exception to the normal beautification 
rules. 

tabexpand 

(bool) Expand tabs to spaces during file transfers; abbreviated tab; default value is 
false. Each tab is expanded to 8 spaces. 

verbose 

(bool) Verbose mode; abbreviated verb; default is true. When verbose mode is enabled, 
tip prints messages while dialing, shows the current number of lines transferred during 
a file transfer operations, and more. 

SHELL 

(str) The name of the shell to use for the '! command; default value is “/bin/sh”, or 
taken from the environment. 
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HOME 

(str) The home directory to use for the ~c command; default value is taken from the 
environment. 

FILES 

/etc/remote 
/etc/phones 
${REMOTE} 

${PHONES} 

'/.tiprc 

/ usr/spool/uucp/LCK.. * 

DIAGNOSTICS 

Diagnostics are, hopefully, self explanatory. 

SEE ALSO 

remote(5), phones(5) 


global system descriptions 
global phone number data base 
private system descriptions 
private phone numbers 
initialization file. 

lock file to avoid conflicts with uucp 


BUGS 

The full set of variables is undocumented and should, probably, be pared down. 
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NAME 

tk - paginator for the Tektronix 4014 


SYNOPSIS 

tk [ —t ] [ —N ] [ —pL ] [ file ] 


DESCRIPTION 

The output of tk is intended for a Tektronix 4014 terminal. Tk arranges for 66 lines to fit on 
the screen, divides the screen into N columns, and contributes an eight space page offset in the 
(default) single-column case. Tabs, spaces, and backspaces are collected and plotted when 
necessary. Teletype Model 37 half- and reverse-line sequences are interpreted and plotted. At 
the end of each page tk waits for a newline (empty line) from the keyboard before continuing 
on to the next page. In this wait state, the command !command will send the command to 
the shell. 

The command line options are: 

—t Don’t wait between pages; for directing output into a file. 

—N Divide the screen into A columns and wait after the last column. 

—p L Set page length to L lines. 


SEE ALSO 

pr(l) 
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NAME 

tmail - print out mail messages, most recent first 
SYNOPSIS 

tmail [ username ] [ mboxfile ] 

DESCRIPTION 

Tmail prints mail messages in reverse order (most recent first). If no argument is given, tmail 
looks in your system maildrop (/usr/spool/mail/%USER). An argument which is a valid user- 
name causes tmail to look in that person’s maildrop; otherwise the argument should be the 
name of a “mailbox” file. 

SEE ALSO 

tac(l), cat(l). 


BUGS 

Should handle multiple arguments. 
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NAME 

touch - update date last modified of a file 

SYNOPSIS 

touch [ — c ] [ -f ] file ... 

DESCRIPTION 

Touch attempts to set the modified date of each file. If a file exists, this is done by reading a 
character from the file and writing it back. If a file does not exist, an attempt will be made to 
create it unless the —c option is specified. The —f option will attempt to force the touch in 
spite of read and write permissions on a file. 

SEE ALSO 

utimes(2) 
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NAME 

tr - translate characters 

SYNOPSIS 

tr [ —cds ] [ stringl [ string2 ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters found in stringl are mapped into the corresponding characters of 
strings. When strings is short it is padded to the length of stringl by duplicating its last 
character. Any combination of the options —cds may be used: — c complements the set of 
characters in stringl with respect to the universe of characters whose ASCII codes are 01 
through 0377 octal; — d deletes all input characters in stringl; — s squeezes all strings of 
repeated output characters that are in strings to single characters. 

In either string the notation a-b means a range of characters from a to 6 in increasing ASCII 
order. The character ‘\ followed by 1, 2 or 3 octal digits stands for the character whose 
ASCII code is given by those digits. A ‘\’ followed by any other character stands for that 
character. 

The following example creates a list of all the words in ‘filel’ one per line in l file2’, where a 
word is taken to be a maximal string of alphabetics. The second string is quoted to protect 
‘\’ from the Shell. 012 is the ASCII code for newline. 

tr-cs A-Za-z '\012' <filel >file2 


SEE ALSO 

ed(l), ascii(7), expand(l) 


BUGS 

Won’t handle ASCII NUL in stringl or stringS; always deletes NUL from input. 
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NAME 

trman - translate version 6 manual macros to version 7 macros 

SYNOPSIS 

trman [ file ] 

DESCRIPTION 

Trman reads the input file, which should be nroff/troff input and attempts to translate the 
version 6 manual sections therein to version 7 format. It is largely successful, but seems to 
have trouble with indented paragraphs and complicated font control. You should expect to 
have to fix up long sections by hand somewhat. 

SEE ALSO 

man(7) 


BUGS 


ICON INTERNATIONAL 


1 


TROFF (1) 


USER COMMANDS 


TROFF (1) 


NAME 

troff, nroff - text formatting and typesetting 

SYNOPSIS 

troff [ option ] ... [ file ] ... 
nroff [ option ] ... [ file ] ... 

DESCRIPTION 

Troff formats text in the named files for printing on a Graphic Systems C/A/T photo- 
typesetter; nroff is used for for typewriter-like devices. Their capabilities are described in the 
Nroff/ Troff user’s manual. 

If no file argument is present, the standard input is read. An argument consisting of a single 
minus (-) is taken to be a file name corresponding to the standard input. The options, which 
may appear in any order so long as they appear before the files, are: 

—o list Print only pages whose page numbers appear in the comma-separated list of 

numbers and ranges. A range N—M means pages TV through M; an initial -A r means 
from the beginning to page TV; and a final TV- means from TV to the end. 

—nTV Number first generated page TV. 

—sN Stop every TV pages. Nroff will halt prior to every TV pages (default N=l) to allow 
paper loading or changing, and will resume upon receipt of a newline. Troff will 
stop the phototypesetter every TV pages, produce a trailer to allow changing 
cassettes, and resume "when the typesetter’s start button is pressed. 

— m name Prepend the macro file /usr/lib/tmac/tmac. name to the input files. 

-raN Set register a (one-character) to N. 

—i Read standard input after the input files are exhausted. 

—q Invoke the simultaneous input-output mode of the rd request. 

Troff only 

—t Direct output to the standard output instead of the phototypesetter. 

—f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

—w Wait until phototypesetter is available, if currently busy. 

—b Report whether the phototypesetter is busy or available. No text processing is done. 

-a Send a printable ASCII approximation of the results to the standard output. 

—pN Print all characters in point size TV while retaining all prescribed spacings and 

motions, to reduce phototypesetter elapsed time. 

-F fontdir 

The directory fontdir contains the font width tables /usr/lib/fonts. This option can 
be used to produce output for devices besides the phototypesetter. 


If the file /usr/adm/tracct is writable, troff keeps phototypesetter accounting records there. 
The integrity of that file may be secured by making troff a ’set user-id’ program. 


FILES 

/tmp/ta* temporary file 

/usr/lib/tmac/tmac.* standard macro files 
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/usr/lib/term/* 
/usr/lib/font/* 
/dev/cat 
/usr/adm/tracct 


terminal driving tables for nroff 
font width tables for troff 
phototypesetter 

accounting statistics for /dev/cat 


SEE ALSO 

J. F. Ossanna, Nroff/ Troff user’s manual 
B. W. Kernighan, A TROFF Tutorial 
eqn(l), tbl(l), ms(7), me(7), man(7), col(l) 


2 


ICON INTERNATIONAL 



TRUE (1) 


USER COMMANDS 


TRUE (1) 


NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True and false are usually used in a Bourne shell script. They test for the appropriate status 
"true" or "false" before running (or failing to run) a list of commands. 

EXAMPLE 

while true 
do 

command list 
done 

SEE ALSO 

csh(l), sh(l), false(l) 

DIAGNOSTICS 

True has exit status zero. 
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NAME 

tset - terminal dependent initialization 
SYNOPSIS 

tset [ options ] [ —m [ident][test baudrate]:type ] ... [ type ] 

reset ... 

DESCRIPTION 

Tset sets up your terminal when you first log in to a UNIX system. It does terminal depen¬ 
dent processing such as setting erase and kill characters, setting or resetting delays, sending 
any sequences needed to properly initialized the terminal, and the like. It first determines the 
type of terminal involved, and then does necessary initializations and mode settings. The type 
of terminal attached to each UNIX port is specified in the / etc/ttytype database. Type names 
for terminals may be found in the termcap{ 5) database. If a port is not wired permanently to 
a specific terminal (not hardwired) it will be given an appropriate generic identifier such as 
dialup. 

In the case where no arguments are specified, tset simply reads the terminal type out of the 
environment variable TERM and re-initializes the terminal. The rest of this manual concerns 
itself with mode and environment initialization, typically done once at login, and options used 
at initialization time to determine the terminal type and set up terminal modes. 

When used in a startup script (. profile for sh( 1) users or .login for cs/i(l) users) it is desirable 
to give information about the type of terminal you will usually use on ports which are not 
hardwired. These ports are identified in /etc/ttytype as dialup or plugboard or arpanet, etc. 
To specify what terminal type you usually use on these ports, the -m (map) option flag is fol¬ 
lowed by the appropriate port type identifier, an optional baud rate specification, and the ter¬ 
minal type. (The effect is to “map” from some conditions to a terminal type, that is, to tell 
tset “If I’m on this kind of port, guess that I’m on that kind of terminal”.) If more than one 
mapping is specified, the first applicable mapping prevails. A missing port type identifier 
matches all identifiers. Any of the alternate generic names given in termcap may be used for 
the identifier. 

A baudrate is specified as with stty(l), and is compared with the speed of the diagnostic out¬ 
put (which should be the control terminal). The baud rate test may be any combination of: 
>, @, <, and !; @ means “at” and ! inverts the sense of the test. To avoid problems with 
metacharacters, it is best to place the entire argument to -m within characters; users of 
csA(l) must also put a “\” before any “!” used here. 

Thus 

tset-m 'dialup>300:adm3a'-m dialup:dw2 -m 'plugboard:?adm3a' 

causes the terminal type to be set to an admSa if the port in use is a dialup at a speed greater 
than 300 baud; to a dwS if the port is (otherwise) a dialup (i.e. at 300 baud or less). (NOTE: 
the examples given here appear to take up more than one line, for text processing reasons. 
When you type in real tset commands, you must enter them entirely on one line.) If the type 
finally determined by tset begins with a question mark, the user is asked if s/he really wants 
that type. A null response means to use that type; otherwise, another type can be entered 
which will be used instead. Thus, in the above case, the user will be queried on a plugboard 
port as to whether they are actually using an admSa. 

If no mapping applies and a final type option, not preceded by a —m, is given on the com¬ 
mand line then that type is used; otherwise the identifier found in the /etc/ttytype database 
will be taken to be the terminal type. This should always be the case for hardwired ports. 
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It is usually desirable to return the terminal type, as finally determined by tset , and informa¬ 
tion about the terminal’s capabilities to a shell’s environment. This can be done using the — 
option; using the Bourne shell, sh(l): 

export TERM; TERM='tset - options...' 
or using the C shell, csh( 1): 

setenv TERM 'tset - options...' 

With csh it is convenient to make an alias in your .cshrc: 

alias tset setenv TERM 'tset - \!* w 
Either of these aliases allow the command 
tset 2621 

to be invoked at any time from your login csh. Note to Bourne Shell users: It is not pos¬ 
sible to get this aliasing effect with a shell script, because shell scripts cannot set the environ¬ 
ment of their parent. (If a process could set its parent’s environment, none of this nonsense 
would be necessary in the first place.) 

These commands cause tset to place the name of your terminal in the variable TERM in the 
environment; see environ( 7). 

Once the terminal type is known, tset engages in terminal driver mode setting. This normally 
involves sending an initialization sequence to the terminal, setting the single character erase 
(and optionally the line-kill (full line erase)) characters, and setting special character delays. 
Tab and newline expansion are turned off during transmission of the terminal initialization 
sequence. 

On terminals that can backspace but not overstrike (such as a CRT), and when the erase char¬ 
acter is the default erase character (‘#’ on standard systems), the erase character is changed 
to BACKSPACE (Control-H). 

The options are: 

—ec set the erase character to be the named character c on all terminals, the default being 
the backspace character on the terminal, usually "H. The character c can either be 
typed directly, or entered using the hat notation used here. 

—kc is similar to —e but for the line kill character rather than the erase character; c 
defaults to "X (for purely historical reasons). The kill characters is left alone if -k is 
not specified. The hat notation can also be used for this option. 

— The name of the terminal finally decided upon is output on the standard output. This 
is intended to be captured by the shell and placed in the environment variable TERM. 

-n On systems with the Berkeley 4BSD tty driver, specifies that the new tty driver modes 
should be initialized for this terminal. For a CRT, the CRTERASE and CRTKILL 
modes are set only if the baud rate is 1200 or greater. See tty(4) for more detail. 

-I suppresses transmitting terminal initialization strings. 

-Q suppresses printing the “Erase set to” and “Kill set to” messages. 

If tset is invoked as reset, it will set cooked and echo modes, turn off cbreak and raw modes, 
turn on newline translation, and restore special characters to a sensible state before any termi¬ 
nal dependent processing is done. Any special character that is found to be NULL or “-1” is 
reset to its default value. 

This is most useful after a program dies leaving a terminal in a funny state. You may have to 
type “<LF>reset<LF>” to get it to work since <CR> may not work in this state. Often none 
of this will echo. 
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EXAMPLES 

These examples all assume the Bourne shell and use the - option. If you use csh, use one of 
the variations described above. Note that a typical use of tset in a .profile or .login will also 
use the -e and — k options, and often the — n or -Q options as well. These options have not 
been included here to keep the examples small. (NOTE: some of the examples given here 
appear to take up more than one line, for text processing reasons. When you type in real tset 
commands, you must enter them entirely on one line.) 

At the moment, you are on a 2621. This is suitable for typing by hand but not for a .profile, 
unless you are always on a 2621. 

export TERM; TERM='tset - 2621' 

You have an hl9 at home which you dial up on, but your office terminal is hardwired and 
known in /etc/ttytype. 

export TERM; TERM='tset —m dialup:hl9' 

You have a switch which connects everything to everything, making it nearly impossible to 
key on what port you are coming in on. You use a vtlOO in your office at 9600 baud, and dial 
up to sw'itch ports at 1200 baud from home on a 2621. Sometimes you use someone elses ter¬ 
minal at work, so you want it to ask you to make sure what terminal type you have at high 
speeds, but at 1200 baud you are always on a 2621. Note the placement of the question 
mark, and the quotes to protect the greater than and question mark from interpretation by 
the shell. 

export TERM; TERM='tset —m ’switch >1200:?vtl00’ -m ’switch <=1200:2621’ 

All of the above entries will fall back on the terminal type specified in /etc/ttytype if none of 
the conditions hold. The following entry is appropriate if you always dial up, always at the 
same baud rate, on many different kinds of terminals. Your most common terminal is an 
adm3a. It always asks you what kind of terminal you are on, defaulting to adm3a. 

export TERM; TERM='tset - ?adm3a' 

If the file /etc/ttytype is not properly installed and you want to key entirely on the baud rate, 
the following can be used: 

export TERM; TERM='tset —m ’>1200:vtl00’ 2621' 

Here is a fancy example to illustrate the power of tset and to hopelessly confuse anyone who 
has made it this far. You dial up at 1200 baud or less on a conceptlOO, sometimes over 
switch ports and sometimes over regular dialups. You use various terminals at speeds higher 
than 1200 over switch ports, most often the terminal in your office, which is a vtlOO. How¬ 
ever, sometimes you log in from the university you used to go to, over the ARPANET; in this 
case you are on an ALTO emulating a dm2500. You also often log in on various hardwired 
ports, such as the console, all of which are properly entered in /etc/ttytype. You want your 
erase character set to control H, your kill character set to control U, and don’t want tset to 
print the “Erase set to Backspace, Kill set to Control U” message. 

export TERM; TERM='tset -e -k~U -Q - -m ’switch<=1200:conceptl00’ -m 
’switch:?vtl00’ -m dialup:conceptl00 -m arpanet:dm2500' 


FILES 

/etc/ttytype port name to terminal type mapping database 
/etc/termcap terminal capability database 


ICON INTERNATIONAL 


3 



TSET (1) 


USER COMMANDS 


TSET (1) 


SEE ALSO 

csh(l), sh(l), stty(l), ttytype(5), termcap(5), environ(7) 

AUTHORS 

Eric Allman 
David Wasley 
Mark Horton 


BUGS 

The tset command is one of the first commands a user must master when getting started on a 
UMX system. Unfortunately, it is one of the most complex, largely because of the extra effort 
the user must go through to get the environment of the login shell set. Something needs to be 
done to make all this simpler, either the login( 1) program should do this stuff, or a default 
shell alias should be made, or a way to set the environment of the parent should exist. 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is 
understood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l) 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive 
file. 
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NAME 

tty - get terminal name 

SYNOPSIS 

tty [-s ] 


DESCRIPTION 

Tty prints the pathname of the user’s terminal unless the -s (silent) is given. In either case, 
the exit value is zero if the standard input is a terminal and one if it is not. 


DIAGNOSTICS 

‘not a tty’ if the standard input file is not a terminal. 
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NAME 

ul - do underlining 

SYNOPSIS 

ul [ —i ] [ —t terminal ] [ name ... ] 

DESCRIPTION 

Ul reads the named files (or standard input if none are given) and translates occurrences of 
underscores to the sequence which indicates underlining for the terminal in use, as specified by 
the environment variable TERM. The —t option overrides the terminal kind specified in the 
environment. The file /etc/termcap is read to determine the appropriate sequences for under¬ 
lining. If the terminal is incapable of underlining, but is capable of a standout mode then 
that is used instead. If the terminal can overstrike, or handles underlining automatically, ul 
degenerates to cat(l). If the terminal cannot underline, underlining is ignored. 

The —i option causes ul to indicate underlining onto by a separate line containing appropriate 
dashes this is useful when you want to look at the underlining which is present in an nroff 
output stream on a crt-terminal. 

SEE ALSO 

man(l), nroff(l), colcrt(l) 

AUTHOR 

Mark Horton wrote ul. The —i option was originally a option of the editor ex(l), then an iul 
command. 


BUGS 

Nroff usually outputs a series of backspaces and underlines intermixed with the text to indi¬ 
cate underlining. No attempt is made to optimize the backward motion. 
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NAME 

unifdef - remove ifdefed lines 

SYNOPSIS 

unifdef [ —t —1 —c —D sym —U sym —id sym -iu sym ] ... [ file ] 

DESCRIPTION 

Unifdef is useful for removing ifdef’ed lines from a file while otherwise leaving the file alone. 
Unifdef is like a stripped-down C preprocessor: it is smart enough to deal with the nested 
ifdefs, comments, single and double quotes of C syntax so that it can do its job, but it doesn’t 
do any including or interpretation of macros. Neither does it strip out comments, though it 
recognizes and ignores them. You specify which symbols you want defined —D sym or 
undefined -U sym and the lines inside those ifdefs will be copied to the output or removed as 
appropriate. The ifdef, ifndef, else, and endif lines associated with sym will also be removed. 
Ifdefs involving symbols you don’t specify are untouched and copied out along with their 
associated ifdef, else, and endif lines. If an ifdef X occurs nested inside another ifdef X, then 
the inside ifdef is treated as if it were an unrecognized symbol. If the same symbol appears in 
more than one argument, only the first occurrence is significant. 

The -1 option causes unifdef to replace removed lines with blank lines instead of deleting 
them. 

If you use ifdefs to delimit non-C lines, such as comments or code which is under construction, 
then you must tell unifdef which symbols are used for that purpose so that it won’t try to 
parse for quotes and comments in those ifdef’ed lines. You specify that you want the lines 
inside certain ifdefs to be ignored but copied out with -id sym and -iu sym similar to —D sym 
and —U sym above. 

If you want to use unifdef for plain text (not C code), use the -t option. This makes unifdef 
refrain from attempting to recognize comments and single and double quotes. 

Unifdef copies its output to stdout and will take its input from stdin if no file argument is 
given. If the —c argument is specified, then the operation of unifdef is complemented, i.e. the 
lines that would have been removed or blanked are retained and vice versa. 

SEE ALSO 

diff(l) 

DIAGNOSTICS 

Premature EOF, inappropriate else or endif. 

Exit status is 0 if output is exact copy of input, 1 if not, 2 if trouble. 


BUGS 

Does not know how to deal with cpp consructs such as 
#if defined(X) || defined(Y) 


AUTHOR 

Dave Yost 
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NAME 

uniq - report repeated lines in a file 

SYNOPSIS 

uniq [ —udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and 
succeeding copies of repeated lines are removed; the remainder is written on the output file. 
Note that repeated lines must be adjacent in order to be found; see sort( 1). If the —u flag is 
used, just the lines that are not repeated in the original file are output. The — d option 
specifies that one copy of just the repeated lines is to be written. The normal mode output is 
the union of the —u and — d mode outputs. 

The —c option supersedes -u and -d and generates an output report in default style but with 
each line preceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

—n The first n fields together with any blanks before each are ignored. A field is defined 
as a string of non-space, non-tab characters separated by tabs and spaces from its 
neighbors. 

+ n The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

sort(l), comm(l) 
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NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their equivalents in other 
scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.54000e+00 
/ S.9S701e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a 
numeric multiplier. Powers are indicated by suffixed positive integers, division by the usual 
sign: 

You have: 15 pounds force/in2 
You want: atm 

* 1.02069e+00 
/ 9.79780e-01 

Units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not 
Centigrade to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recog¬ 
nized, together with a generous leavening of exotica and a few constants of nature including: 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g 

mole Avogadro’s number 

water pressure head per unit height of water 

au astronomical unit 

‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘light-year’. British units 
that differ from their US counterparts are prefixed thus: ‘brgallon’. Currency is denoted ‘bel- 
giumfranc’, ‘britainpound’, ... 

For a complete list of units, ‘cat /usr/lib/units’. 


FILES 

/usr/lib/units 

BUGS 

Don’t base your financial plans on the currency conversions. 
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NAME 

uptime - show how long system has been up 

SYNOPSIS 

uptime 


DESCRIPTION 

Uptime prints the current time, the length of time the system has been up, and the average 
number of jobs in the run queue over the last 1, 5 and 15 minutes. It is, essentially, the first 
line of a u/(l) command. 

FILES 

/vmunix system name list 

SEE ALSO 

w(l) 
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NAME 

users - compact list of users who are on the system 

SYNOPSIS 

users 

DESCRIPTION 

Users lists the login names of the users currently on the system in a compact, one-line format. 

FILES 

/etc/utmp 

SEE ALSO 

who(l) 
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NAME 

uucp, uulog - unix to unix copy 

SYNOPSIS 

uucp [ option ] ... source-file ... destination-file 
uulog [ option ] ... 

DESCRIPTION 

Uucp copies files named by the source-file arguments to the destination-file argument. A file 
name may be a path name on your machine, or may have the form 

system-namelpathname 

where ‘system-name’ is taken from a list of system names which uucp knows about. Shell 
metacharacters ?*[] appearing in the pathname part will be expanded on the appropriate sys¬ 
tem. 

Pathnames may be one of 

(1) a full pathname; 

(2) a pathname preceded by 'user; where user is a userid on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

If the result is an erroneous pathname for the remote system the copy will fail. If the 
destination-file is a directory, the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write per¬ 
missions (see chmod{ 2)). 

The following options are interpreted by uucp. 

-d Make all necessary directories for the file copy. 

-c Use the source file when copying out rather than copying the file to the spool direc¬ 
tory. 

-m Send mail to the requester when the copy is complete. 

Uulog maintains a summary log of uucp and uui(lC) transactions in the file 
‘/usr/spool/uucp/LOGFILE’ by gathering information from partial log files named 
‘/usr/spool/uucp/LOG.*.?’. It removes the partial log files. 

The options cause uulog to print logging information: 

-s sys Print information about work involving system sys. 

-uuser Print information about work done for the specified user. 


FILES 

/usr/spool/uucp - spool directory 
/usr/lib/uucp/* - other data and program files 

SEE ALSO 

uux(lC), mail(l) 

D. A. Nowitz, Uucp Implementation Description 
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WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) 
be severely restricted. You will very likely not be able to fetch files by pathname; ask a 
responsible person on the remote system to send them to you. For the same reasons you will 
probably not be able to send files to arbitrary pathnames. 


BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. (Receiving multiple files 
specified by special shell characters ?*[] will not activate the -m option.) 
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NAME 

uuencode,uudecode - encode/decode a binary file for transmission via mail 

SYNOPSIS 

uuencode [ source ] remotedest | mail sysl!sys2!..!decode 
uudecode [ file ] 



DESCRIPTION 

Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combina¬ 
tion can be used over indirect mail links even when uusend(lC) is not available. 

Uuencode takes the named source file (default standard input) and produces an encoded ver¬ 
sion on the standard output. The encoding uses only printing ASCII characters, and includes 
the mode of the file and the remotedest for recreation on the remote system. 

Uudecode reads an encoded file, strips off any leading and trailing lines added by mailers, and 
recreates the original file with the specified mode and name. 

The intent is that all mail to the user “decode” should be filtered through the uudecode pro¬ 
gram. This way the file is created automatically without human intervention. This is possi¬ 
ble on the uucp network by either using sendmail or by making rmail be a link to Mail 
instead of mail. In each case, an alias must be created in a master file to get the automatic 
invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the remote machine who 
can uudecode it manually. 

The encode file has an ordinary text form and can be edited by any text editor to change the 
mode or remote name. 

SEE ALSO 

uuencode(5), uusend(lC), uucp(lC), uux(lC), mail(l) 


AUTHOR 

Mark Horton 


BUGS 

The file is expanded by 35% (3 bytes become 4 plus control information) causing it to take 
longer to transmit. 

The user on the remote system who is invoking uudecode (often uucp) must have write per¬ 
mission on the specified file. 
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NAME 

uusend - send a file to a remote host 

SYNOPSIS 

uusend [ — m mode ] sourcefile sysl!sys2!..!remotefile 

DESCRIPTION 

Uusend sends a file to a given location on a remote system. The system need not be directly 
connected to the local system, but a chain of uucp(lC) links needs to connect the two sys¬ 
tems. 

If the —m option is specified, the mode of the file on the remote end will be taken from the 
octal number given. Otherwise, the mode of the input file will be used. 

The sourcefile can be meaning to use the standard input. Both of these options are pri¬ 
marily intended for internal use of uusend. 

The remotefile can include the "userid syntax. 

DIAGNOSTICS 

If anything goes wrong any further away than the first system down the line, you will never 
hear about it. 

SEE ALSO 

uux(lC), uucp(lC), uuencode(l) 

AUTHOR 

Mark Horton 


BUGS 

This command shouldn’t exist, since uucp should handle it. 

All systems along the line must have the uusend command available and allow remote execu¬ 
tion of it. 

Some uucp systems have a bug where binary files cannot be the input to a uux command. If 
this bug exists in any system along the line, the file will show up severly munged. 
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NAME 

uux - unix to unix command execution 
SYNOPSIS 

uux [ — ] command-string 

DESCRIPTION 

Uux will gather 0 or more files from various systems, execute a command on a specified system 
and send standard output to a file on a specified system. 

The command-string is made up of one or more arguments that look like a shell command 
line, except that the command and file names may be prefixed by system-name!. A null 
system-name is interpreted as the local system. 

File names may be one of 

(1) a full pathname; 

(2) a pathname preceded by “ xxx; where xxx is a userid on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

The option will cause the standard input to the uux command to be the standard input to 
the command-string. 

For example, the command 

uux "!diff usg!/usr/dan/fl pwba!/a4/dan/fl > Ifi.diff" 

will get the fl files from the usg and pwba machines, execute a diff command and put the 
results in f 1 .diff in the local directory. 

Any special shell characters such as <>;| should be quoted either by quoting the entire 
command-string, or quoting the special characters as individual arguments. 


FILES 

/usr/spool/uucp spool directory 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

uucp(lC) 

D. A. Nowitz, Uucp Implementation Description 

WARNING 

An installation may, and for security reasons generally will, limit the list of commands execut¬ 
able on behalf of an incoming request from uux. Typically, a restricted site will permit little 
other than the receipt of mail via uux. 


BUGS 

Only the first command of a shell pipeline may have a system-name!. All other commands are 
executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. 

The shell tokens < < and > > are not implemented. 

There is no notification of denial of execution on the remote machine. 
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NAME 

vers - print version number of the kernel 

SYNOPSIS 

vers [ -v ] 

DESCRIPTION 

Vers prints the version number of the currently running UNIX kernel. It prints the same 
message that is seen at boot time. The —v (verbose) flag is used to determine the actual path¬ 
name of the kernel. 
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NAME 

vgrind - grind nice listings of programs 

SYNOPSIS 

vgrind [ _f ] [ - ] [ _t ] [ -n ] [ -x ] [ -W ] [ -sn ] [ —h header ] [ — d file ] [ —1 language ] 
name ... 

DESCRIPTION 

Vgrind formats the program sources which are arguments in a nice style using troff[ 1) Com¬ 
ments are placed in italics, keywords in bold face, and the name of the current function is 
listed down the margin of each page as it is encountered. 

Vgrind runs in two basic modes, filter mode or regular mode. In filter mode vgrind acts as a 
filter in a manner similar to (6/(1). The standard input is passed directly to the standard out¬ 
put except for lines bracketed by the troff-like macros: 

.vS - starts processing 

.vE - ends processing 

These lines are formatted as described above. The output from this filter can be passed to 
troff for output. There need be no particular ordering with egn(l) or (6/(1). 

In regular mode vgrind accepts input files, processes them, and passes them to troff{ 1) for out¬ 
put. 

In both modes vgrind passes any lines beginning with a decimal point without conversion. 

The options are: 

—f forces filter mode 

— forces input to be taken from standard input (default if —f is specified ) 

—t similar to the same option in troff causing format ted text to go to the standard output 

-n forces no keyword bolding 

-x outputs the index file in a “pretty” format. The index file itself is produced whenever 

vgrind is run with a file called index in the current directory. The index of function 
definitions can then be run off by giving vgrind the -x option and the file index as 
argument. 

—W forces output to the (wide) Versatec printer rather than the (narrow) Varian 
—s specifies a point size to use on output (exactly the same as the argument of a .ps) 

-h specifies a particular header to put on every output page (default is the file name) 

— d specifies an alternate language definitions file (default is /usr/lib/vgrindefs) 

—1 specifies the language to use. Currently known are PASCAL (-Ip), MODEL (-lm),C 
(-lc or the default), CSH (-lcsh), SHELL (-lsh), RATFOR (-lr), and ICON (-11). 

FILES 

index file where source for index is created 

/usr/lib/tmac/tmac.vgrind macro package 
/usr/lib/vfontedpr preprocessor 

/usr/lib/vgrindefs language descriptions 
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AUTHOR 

Dave Presotto & William Joy 

SEE ALSO 

vlp(l), vtroff(l), vgrindefs(5) 


BUGS 

Vfontedpr assumes that a certain programming style is followed: 

For C - function names can be preceded on a line only by spaces, tabs, or an asterisk. The 
parenthesized arguments must also be on the same line. 

For PASCAL - function names need to appear on the same line as the keywords function or 
procedure. 

For MODEL - function names need to appear on the same line as the keywords is beginproc. 

If these conventions are not followed, the indexing and marginal function name comment 
mechanisms will fail. 

More generally, arbitrary formatting styles for programs mostly look bad. The use of spaces 
to align source code fails miserably; if you plan to vgrind your program you should use tabs. 
This is somewhat inevitable since the font used by vgrind is variable width. 

The mechanism of ctags in recognizing functions should be used here. 
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NAME 

vi - screen oriented (visual) display editor based on ex 

SYNOPSIS 

vi [ —t tag ] [ — r ] [ 4 -command ] [ -1 ] [ -wn ] name ... 

DESCRIPTION 

V* (visual) is a display oriented text editor based on ez(l). Ex and vi run the same code; it is 
possible to get to the command mode of ex from within vi and vice-versa. 

The Vi Quick Reference card and the Introduction to Display Editing with Vi provide full 
details on using vi. 


FILES 

See ex(l). 

SEE ALSO 

ex (1), edit (1), “Vi Quick Reference” card, “An Introduction to Display Editing with Vi”. 

AUTHOR 

William Joy 

Mark Horton added macros to visual mode and is maintaining version 3 


BUGS 

Software tabs using "T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals don’t make use of insert and delete character 
operations in the terminal. 

The wrapmargin option can be fooled since it looks at output columns when blanks are typed. 
If a long word passes through the margin and onto the next line without a break, then the 
line won’t be broken. 

Insert/delete within a line can be slow if tabs are present on intelligent terminals, since the 
terminals need help in doing this correctly. 

Saving text on deletes in the named buffers is somewhat inefficient. 

The source command does not work when executed as :source; there is no way to use the 
:append, :change, and :insert commands, since it is not possible to give more than one line 
of input to a : escape. To use these on a :global you must Q to ex command mode, execute 
them, and then reenter the screen editor with vi or open. 
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NAME 

vmstat - report virtual memory statistics 

SYNOPSIS 

vmstat [ -fs ] [ interval [ count ] ] 

DESCRIPTION 

Vmstat delves into the system and normally reports certain statistics kept about process, vir¬ 
tual memory, disk, trap and cpu activity. If given a -f argument, it instead reports on the 
number of forks and vforks since system startup and the number of pages of virtual memory 
involved in each kind of fork. If given a —s argument, it instead prints the contents of the 
sum structure, giving the total number of several kinds of paging related events which have 
occurred since boot. 

If none of these options are given, vmstat will report in the first line a summary of the virtual 
memory activity since the system has been booted. If interval is specified, then successive lines 
are summaries over the last interval seconds, “vmstat 5” will print what the system is doing 
every five seconds; this is a good choice of printing interval since this is how often some of the 
statistics are sampled in the system; others vary every second, running the output for a while 
will make it apparent which are recomputed every second. If a count is given, the statistics 
are repeated count times. The format fields are: 

Procs: information about numbers of processes in various states, 
r in run queue 

b blocked for resources (i/o, paging, etc.) 

w runnable or short sleeper (< 20 secs) but swapped 

Memory: information about the usage of virtual and real memory. Virtual pages are con¬ 
sidered active if they belong to processes which are running or have run in the last 20 seconds. 
A “page” here is 1024 bytes. 

avm active virtual pages 

fre size of the free list 

Page: information about page faults and paging activity. These are averaged each five 
seconds, and given in units per second. 

re page reclaims (simulating reference bits) 

pi pages paged in 

po pages paged out 

fr pages freed per second 

de anticipated short term memory shortfall 

sr pages scanned by clock algorithm, per-second 

up/hp/rk: Disk operations per second (this field is system dependent). Typically paging will 
be split across several of the available drives. The number under each of these is the unit 
number. 

Faults: trap/interrupt rate averages per second over last 5 seconds. 

in (non clock) device interrupts per second 

sy system calls per second 

cs cpu context switch rate (switches/sec) 
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Cpu: breakdown of percentage usage of CPU time 

us user time for normal and low priority processes 

sy system time 

id cpu idle 

FILES 

/dev/kmem, /vmunix 


SEE ALSO 

The sections starting with “Interpreting system activity” in Installing and Operating 4-Sbsd. 
AUTHORS 

William Joy and Ozalp Babaoglu 

BUGS 

There should be a screen oriented program which combines vmstat and ps(l) in real time as 
well as reporting on other system activity. 
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NAME 

w - who is on and what they are doing 


X' N 



SYNOPSIS 

w [ -h J [ — s ] [ user ] 

DESCRIPTION 

W prints a summary of the current activity on the system, including what each user is doing. 
The heading line shows the current time of day, how long the system has been up, the 
number of users logged into the system, and the load averages. The load average numbers 
give the number of jobs in the run queue averaged over 1, 5 and 15 minutes. 

The fields output are: the users login name, the name of the tty the user is on, the time of 
day the user logged on, the number of minutes since the user last typed anything, the CPU 
time used by all processes and their children on that terminal, the CPU time used by the 
currently active processes, the name and arguments of the current process. 

The — h flag suppresses the heading. The — s flag asks for a short form of output. In the 
short form, the tty is abbreviated, the login time and cpu times are left off, as are the argu¬ 
ments to commands. -1 gives the long output, which is the default. 

If a user name is included, the output will be restricted to that user. 


FILES 

/etc/utmp 

/dev/kmem 

/dev/drum 

SEE ALSO 

who(l), finger(l), ps(l) 

AUTHOR 

Mark Horton 


BUGS 

The notion of the “current process” is muddy. The current algorithm is “the highest num¬ 
bered process on the terminal that is not ignoring interrupts, or, if there is none, the highest 
numbered process on the terminal”. This fails, for example, in critical sections of programs 
like the shell and editor, or when faulty programs running in the background fork and fail to 
ignore interrupts. (In cases where no process can be found, w prints 

The CPU time is only an estimate, in particular, if someone leaves a background process run¬ 
ning after logging out, the person currently on that terminal is “charged” with the time. 

Background processes are not shown, even though they account for much of the load on the 
system. 

Sometimes processes, typically those in the background, are printed with null or garbaged 
arguments. In these cases, the name of the command is printed in parentheses. 

W does not know about the new conventions for detection of background jobs. It will some¬ 
times find a background job instead of the right one. 
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NAME 

wait - await completion of process 

SYNOPSIS 

wait 

DESCRIPTION 

Wait until all processes started with & have completed, and report on abnormal terminations. 

Because the wait{ 2) system call must be executed in the parent process, the Shell itself exe¬ 
cutes wait, without creating a new process. 

SEE ALSO 

sh(l) 


BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the Shell, and thus can’t be 
waited for. (This bug does not apply to csh( 1).) 
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NAME 

wall - write to all users 

SYNOPSIS 

wall 

DESCRIPTION 

Wall reads its standard input until an end-of-file. It then sends this message, preceded by 
‘Broadcast Message to all logged in users. 

The sender should be super-user to override any protections the users may have invoked. 


FILES 

/dev/tty? 

/etc/utmp 

SEE ALSO 

mesg(l), write(l) 

DIAGNOSTICS 

‘Cannot send to ...’ when the open on a user’s tty file fails. 
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NAME 

wc - word count 

SYNOPSIS 

wc f —Iwc 1 f name ... 


DESCRIPTION 

Wc counts lines, words and characters in the named files, or in the standard input if no name 
appears. A word is a maximal string of characters delimited by spaces, tabs or newlines. 

If an argument beginning with one of “lwc” is present, the specified counts (lines, words, or 
characters) are selected by the letters 1, w, or c. The default is —lwc. 
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NAME 

what - show what versions of object modules were used to construct a file 

SYNOPSIS 

what name ... 

DESCRIPTION 

What reads each file and searches for sequences of the form “@(#)” as inserted by the source 
code control system. It then prints the remainder of the string after this marker, up to a null 
character, newline, double quote, or “>” character. 

BUGS 

As SCCS is not licensed with UNIX/32V, this is a rewrite of the what command which is part 
of SCCS, and may not behave exactly the same as that command does. 
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NAME 

whatis - describe what a command is 

SYNOPSIS 

whatis command ... 

DESCRIPTION 

Whatis looks up a given command and gives the header line from the manual section. You 
can then run the man(l) command to get more information. If the line starts ‘name(section) 
...’ you can do ‘man section name’ to get the documentation for it. Try ‘whatis ed’ and then 
you should do ‘man 1 ed’ to get the manual. 

Whatis is actually just the -f option to the man(l) command. 


FILES 

/usr/lib/whatis Data base 

SEE ALSO 

man(l), catman(8) 

AUTHOR 

William Joy 
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NAME 

whereis - locate source, binary, and or manual for program 

SYNOPSIS 

whereis [ —sbm ] [ —u ] [ -SBM dir ... —f ] name ... 

DESCRIPTION 

Whereis locates source/binary and manuals sections for specified files. The supplied names are 
first stripped of leading pathname components and any (single) trailing extension of the form 
“.ext”, e.g. “.c”. Prefixes of “s.” resulting from use of source code control are also dealt with. 
Whereis then attempts to locate the desired program in a list of standard places. If any of the 
—b, —s or —m flags are given then whereis searches only for binaries, sources or manual sec¬ 
tions respectively (or any two thereof). The -u flag may be used to search for unusual 
entries. A file is said to be unusual if it does not have one entry of each requested type. Thus 
“whereis -m -u *” asks for those files in the current directory which have no documentation. 

Finally, the —B —M and -S flags may be used to change or otherwise limit the places where 
whereis searches. The -f file flags is used to terminate the last such directory list and signal 
the start of file names. 

EXAMPLE 

The following finds all the files in /usr/bin which are not documented in /usr/man/manl 
with source in /usr/src/cmd: 

cd /usr/ucb 

whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 


FILES 

/usr/src/* 

/usr/{doc,man}/* 

/lib, /etc, /usr/{lib,bin,ucb,old,new,local} 

AUTHOR 

William Joy 


BUGS 

Since the program uses chdir( 2) to run faster, pathnames given with the -M -S and -B must 
be full; i.e. they must begin with a “/”. 
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NAME 

which - locate a program file including aliases and paths (csh only) 

SYNOPSIS 

which [ name ] ... 

DESCRIPTION 

Which takes a list of names and looks for the files which would be executed had these names 
been given as commands. Each argument is expanded if it is aliased, and searched for along 
the user’s path. Both aliases and path are taken from the user’s .cshrc file. 


FILES 

'/.cshrc source of aliases and path values 

DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single word, or if an execut¬ 
able file with the argument name was not found in the path. 

BUGS 

Must be executed by a csh, since only csh’s know about aliases. 
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NAME 

who - who is on the system 

SYNOPSIS 

who [ who-file ] [ am I ] 

DESCRIPTION 

Who, without an argument, lists the login name, terminal name, and login time for each 
current UNIX user. 

Without an argument, who examines the / etc/utmp file to obtain its information. If a file is 
given, that file is examined. Typically the given file will be /usr/adm/wtmp, which contains a 
record of all the logins since it was created. Then who lists logins, logouts, and crashes since 
the creation of the wtmp file. Each login is listed with user name, terminal name (with 
‘/dev/’ suppressed), and date and time. When an argument is given, logouts produce a simi¬ 
lar line without a user name. Reboots produce a line with ‘x’ in the place of the device name, 
and a fossil time indicative of when the system went down. 

With two arguments, as in ‘who am P (and also ‘who are you’), who tells who you are logged 
in as. 


FILES 

/etc/utmp 

SEE ALSO 

getuid(2), utmp(5) 
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NAME 

whoami - print effective current user id 

SYNOPSIS 

whoami 

DESCRIPTION 

Whoami prints who you are. It works even if you are su’d, while ‘who am i’ does not 
uses /etc/utmp. 

FILES 

/etc/passwd Name data base 

SEE ALSO 

who (1) 


ICON INTERNATIONAL 


since it 


1 



WHODOS (1) 


USER COMMANDS 


WHODOS (1) 


NAME 

whodos - display information about dose users 

SYNOPSIS 

whodos 

DESCRIPTION 

Whodos is used to display information about dose partition usage. It displays the Multi-link 
partition number, the dose process PID, the tty line of the dose user, the time the process 
started, and the user name for each available partition. The file /etc/mttys tells the total 
number of available partitions. 


FILES 

/usr/spool/uucp/LCK. .mtty, /etc/mttys 

SEE ALSO 

dosc(l) 

NOTE 

If a dose process is terminated other than by exiting, it may leave a lock file in 
/usr/spool/uucp. This file must be deleted before the partition can be reused. If you suspect 
this has happened, verify that the PID for each partition reported as active by whodos is 
listed as an active process by ps(l). If the PID does not exist, you may safely remove the lock 
file to allow the partition to be reused. 
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NAME 

window - window environment 

SYNOPSIS 

window [ —t ] [ —f ] [ —d ] [ —e escape-char ] [ —c command ] 

DESCRIPTION 

Window implements a window environment on ASCII terminals. 

A window is a rectangular portion of the physical terminal screen associated with a set of 
processes. Its size and position can be changed by the user at any time. Processes communi¬ 
cate with their window in the same way they normally interact with a terminal-through their 
standard input, output, and diagnostic file descriptors. The window program handles the 
details of redirecting input an output to and from the windows. At any one time, only one 
window can receive input from the keyboard, but all windows can simultaneously send output 
to the display. 

Windows can overlap and are framed as necessary. Each window is named by one of the 
digits “1” to “9”. This one character identifier, as well as a user definable label string, are 
displayed with the window on the top edge of its frame. A window can be designated to be in 
the foreground, in which case it will always be on top of all normal, non-foreground windows, 
and can be covered only by other foreground windows. A window need not be completely 
within the edges of the terminal screen. Thus a large window (possibly larger than the screen) 
may be positioned to show only a portion of its full size. 

Each window has a cursor and a set of control functions. Most intelligent terminal operations 
such as line and character deletion and insertion are supported. Display modes such as under¬ 
lining and reverse video are available if they are supported by the terminal. In addition, simi¬ 
lar to terminals with multiple pages of memory, each window has a text buffer which can have 
more lines than the window itself. 

OPTIONS 

When window starts up, the commands (see long commands below) contained in the file .win- 
dowrc in the user’s home directory are executed. If it does not exist, two equal sized windows 
spanning the terminal screen are created by default. 

The command line options are 

—t Turn on terse mode (see terse command below). 

—f Fast. Don’t perform any startup action. 

—d Ignore .windowrc and create the two default windows instead. 

—e escape-char 

Set the escape character to escape-char. Escape-char can be a single character, or in 
the form "X where X is any character, meaning control-A - . 

—c command 

Execute the string command as a long command (see below) before doing anything 
else. 

PROCESS ENVIRONMENT 

With each newly created window, a shell program is spawned with its process environment 
tailored to that window. Its standard input, output, and diagnostic file descriptors are bound 
to one end of either a pseudo-terminal ( pty (4)) or a UNIX domain socket ( socketpair (4)). If a 
pseudo-terminal is used, then its special characters and modes (see stty (l)) are copied from 
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the physical terminal. A termcap (5) entry tailored to this window is created and passed as 
environment ( environ (5)) variable TERMCAP. The termcap entry contains the window’s size 
and characteristics as well as information from the physical terminal, such as the existence of 
underline, reverse video, and other display modes, and the codes produced by the terminal’s 
function keys, if any. In addition, the window size attributes of the pseudo-terminal are set 
to reflect the size of this window, and updated whenever it is changed by the user. In particu¬ 
lar, the editor vi (1) uses this information to redraw its display. 

OPERATION 

During normal execution, window can be in one of two states: conversation mode and com¬ 
mand mode. In conversation mode, the terminal’s real cursor is placed at the cursor position 
of a particular window—called the current window—and input from the keyboard is sent to the 
process in that window. The current window is always on top of all other window's, except 
those in foreground. In addition, it is set apart by highlighting its identifier and label in 
reverse video. 

Typing window’s escape character (normally 'P) in conversation mode switches it into com¬ 
mand mode. In command mode, the top line of the terminal screen becomes the command 
prompt w'indow, and window interprets input from the keyboard as commands to manipulate 
windows. 

There are two types of commands: short commands are usually one or two key strokes; long 
commands are strings either typed by the user in the command window (see the command 
below), or read from a file (see source below). 

SHORT COMMANDS 

Below', # represents one of the digits “1” to “9” corresponding to the window's 1 to 9. ' X 
means control-A, where X is any character. In particular, " is control-'. Escape is the 
escape key, or '/. 

# Select window # as the current window and return to conversation mode. 

%# Select window # but stay in command mode. 

Select the previous window and return to conversation mode. This is useful for tog¬ 
gling between tw r o window's. 

escape 

Return to conversation mode. 

'P Return to conversation mode and write 'P to the current window. Thus, typing two 
'P’s in conversation mode sends one to the current window. If the window escape is 
changed to some other character, that character takes the place of 'P here. 

? List a short summary of commands. 

'L Redraw the screen. 

q Exit window. Confirmation is requested. 

'Z Suspend window. 

w Create a new window. The user is prompted for the positions of the upper left and 
lower right corners of the window. The cursor is placed on the screen and the keys 
“h”, “j”, “k”, and “1” move the cursor left, down, up, and right, respectively. The 
keys “H”, “J”, “K”, and “L” move the cursor to the respective limits of the screen. 
Typing a number before the movement keys repeats the movement that number of 
times. Return enters the cursor position as the upper left corner of the w'indow. The 
lower right corner is entered in the same manner. During this process, the placement 
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of the new window is indicated by a rectangular box drawn on the screen, correspond¬ 
ing to where the new window will be framed. Typing escape at any point cancels this 
command. 

This window becomes the current window, and is given the first available ID. The 
default buffer size is used (see nline command below). 

Only fully visible windows can be created this way. 

c# Close window #. The process in the window is sent the hangup signal (see kill (1)). 
Csh (1) should handle this signal correctly and cause no problems. 

m# Move window # to another location. A box in the shape of the window is drawn on 
the screen to indicate the new position of the window, and the same keys as those for 
the w command are used to position the box. The window can be moved partially 
off-screen. 

M# Move window # to its previous position. 

s# Change the size of window #. The user is prompted to enter the new lower right 
corner of the window. A box is drawn to indicate the new window size. The same 
keys used in w and m are used to enter the position. 

S# Change window # to its previous size. 

~Y Scroll the current window up by one line. 

~E Scroll the current window down by one line. 

~U Scroll the current window up by half the window size. 

*D Scroll the current window down by half the window size. 

‘B Scroll the current window up by the full window size. 

*F Scroll the current window down by the full window size, 

h Move the cursor of the current window left by one column, 

j Move the cursor of the current window down by one line, 

k Move the cursor of the current window up by one line. 

1 Move the cursor of the current window right by one column. 

'S Stop output in the current window. 

"Q Start output in the current window. 

: Enter a line to be executed as long commands. Normal line editing characters (erase 

character, erase word, erase line) are supported. 

LONG COMMANDS 

Long commands are a sequence of statements parsed much like a programming language, with 
a syntax similar to that of C. Numeric and string expressions and variables are supported, as 
well as conditional statements. 


There are two data types: string and number. A string is a sequence of letters or digits begin¬ 
ning with a letter. and are considered letters. Alternately, non-alphanumeric charac¬ 
ters can be included in strings by quoting them in or escaping them with “\”. In addi¬ 
tion, the “\” sequences of C are supported, both inside and outside quotes (e.g., “\n” is a new 
line, “\r” a carriage return). For example, these are legal strings: abcde01234, 
ab"$#"cd, ab\$\#cd, "/usr/ucb/window". 
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A number is an integer value in one of three forms: a decimal number, an octal number pre¬ 
ceded by “0”, or a hexadecimal number preceded by “Ox” or “OX”. The natural machine 
integer size is used (i.e., the signed integer type of the C compiler). As in C, a non-zero 
number represents a boolean true. 

The character begins a comment which terminates at the end of the line. 

A statement is either a conditional or an expression. Expression statements are terminated 
with a new line or To continue an expression on the next line, terminate the first line 
with 

CONDITIONAL STATEMENT 

Window has a single control structure: the fully bracketed if statement in the form 
if <expr> then 

<statement> 

elsif <expr> then 

<statement> 


else 

<statement> 


endif 

The else and elsif parts are optional, and the latter can be repeated any number of times. 
<Expr> must be numeric. 

EXPRESSIONS 

Expressions in window are similar to those in the C language, with most C operators sup¬ 
ported on numeric operands. In addition, some are overloaded to operate on strings. 

When an expression is used as a statement, its value is discarded after evaluation. Therefore, 
only expressions with side effects (assignments and function calls) are useful as statements. 

Single valued (no arrays) variables are supported, of both numeric and string values. Some 
variables are predefined. They are listed below. 

The operators in order of increasing precedence: 

<exprl> = <expr2> 

Assignment. The variable of name <exprl>, which must be string valued, is assigned 
the result of <expr2>. Returns the value of <expr2>. 

<exprl> ? <expr2> : <expr3> 

Returns the value of <expr2> if <exprl> evaluates true (non-zero numeric value); 
returns the value of <exprS> otherwise. Only one of <expr2> and <exprS> is 
evaluated. <Exprl> must be numeric. 

<exprl> || <expr2> 

Logical or. Numeric values only. Short circuit evaluation is supported (i.e., if 
<exprl> evaluates true, then <expr2> is not evaluated). 

<exprl> && <expr2> 

Logical and with short circuit evaluation. Numeric values only. 

<exprl> | <expr2> 

Bitwise or. Numeric values only. 

<exprl> * <expr2> 

Bitwise exclusive or. Numeric values only. 
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<exprl> & <expr2> 

Bitwise and. Numeric values only. 

<exprl> == <expr2>, <exprl> !*= <expr2> 

Comparison (equal and not equal, respectively). The boolean result (either 1 or 0) of 
the comparison is returned. The operands can be numeric or string valued. One 
string operand forces the other to be converted to a string in necessary. 

<exprl> < <expr2>, <exprl> > <expr2>, 

Less than, greater than, less than or equal to, greater than or equal to. Both numeric 
and string values, with automatic conversion as above. 

<exprl> << <expr2>, <exprl> >> <expr2> 

If both operands are numbers, <exprl> is bit shifted left (or right) by <expr2> bits. 
If <exprl> is a string, then its first (or last) <expr2> characters are returns (if 
<expr2> is also a string, then its length is used in place of its value). 

<exprl> + <expr2>, <exprl> - <expr2> 

Addition and subtraction on numbers. For if one argument is a string, then the 
other is converted to a string, and the result is the concatenation of the two strings. 

<exprl> * <expr2>, <exprl> / <expr2>, 

Multiplication, division, modulo. Numbers only. 

-<expr>, ~<expr>, !<expr>, $<expr>, $?<expr> 

The first three are unary minus, bitwise complement and logical complement on 
numbers only. The operator, “$”, takes <expr> and returns the value of the variable 
of that name. If <expr> is numeric with value n and it appears within an alias 
macro (see below), then it refers to the nth argument of the alias invocation. “$?” 
tests for the existence of the variable <expr>, and returns 1 if it exists or 0 otherwise. 

<expr > (< arglist >) 

Function call. <Expr> must be a string that is the unique prefix of the name of a 
builtin window function or the full name of a user defined alias macro. In the case of a 
builtin function, <arglist> can be in one of two forms: 

<exprl>, <expr2>, . . . 

argnamel = <exprl>, argname2 = <expr2>, . . . 

The two forms can in fact be intermixed, but the result is unpredictable. Most argu¬ 
ments can be omitted; default values will be supplied for them. The argnames can be 
unique prefixes of the the argument names. The commas separating arguments are 
used only to disambiguate, and can usually be omitted. 

Only the first argument form is valid for user defined aliases. Aliases are defined using 
the alias builtin function (see below). Arguments are accessed via a variant of the 
variable mechanism (see “$” operator above). 

Most functions return value, but some are used for side effect only and so must be 
used as statements. When a function or an alias is used as a statement, the 
parenthesis surrounding the argument list may be omitted. Aliases return no value. 


BUILTIN FUNCTIONS 

The arguments are listed by name in their natural order. Optional arguments are in square 
brackets (“[ ]”). Arguments that have no names are in angle brackets (“<>”). 

alias([<string>], [<string-list>]) 

If no argument is given, all currently defined alias macros are listed. Otherwise, 
<string> is defined as an alias, with expansion < string-list>. The previous 
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definition of <string>, if any, is returned. Default for <string-list> is no change. 

close( < window-list > ) 

Close the windows specified in <window-list>. If <window-list> is the word all, 
than all windows are closed. No value is returned. 

cursormo des( [modes]) 

Set the window cursor to modes. Modes is the bitwise or of the mode bits defined as 
the variables m_u/ (underline), m_rev (reverse video), m_blk (blinking), and m_grp 
(graphics, terminal dependent). Return value is the previous modes. Default is no 
change. For example, cursor($m_rev|$m_blk) sets the window cursors to blinking 
reverse video. 

echo([window], [<string-list>]) 

Write the list of strings, <string-list>, to window, separated by spaces and ter¬ 
minated with a new line. The strings are only displayed in the window, the processes 
in the window are not involved (see write below). No value is returned. Default is the 
current window. 

escape( [escapee]) 

Set the escape character to escape-char. Returns the old escape character as a one 
character string. Default is no change. Escapee can be a string of a single character, 
or in the form * X , meaning control-X. 

foreground([window], [flag]) 

Move window in or out of foreground. Flag can be one of on, off, yes, no, true, or false, 
with obvious meanings, or it can be a numeric expression, in which case a non-zero 
value is true. Returns the old foreground flag as a number. Default for window is the 
current window, default for flag is no change. 

label([window], [label]) 

Set the label of window to label. Returns the old label as a string. Default for window 
is the current window, default for label is no change. To turn off a label, set it to an 
empty string (""). 

listQ No arguments. List the identifiers and labels of all windows. No value is returned. 

nline([nline]) 

Set the default buffer size to nline. Initially, it is 48 lines. Returns the old default 
buffer size. Default is no change. Using a very large buffer can slow the program 
down considerably. 

select( [window]) 

Make window the current window. The previous current window is returned. Default 
is no change. 

shell( [ < strin g-Ibt > ]) 

Set the default window shell program to <string-list>. Returns the first string in the 
old shell setting. Default is no change. Initially, the default shell is taken from the 
environment variable SHELL. 

source(filename) 

Read and execute the long commands in filename. Returns -1 if the file cannot be 
read, 0 otherwise. 

terse([flag]) 

Set terse mode to flag. In terse mode, the command window stays hidden even in 
command mode, and errors are reported by sounding the terminal’s bell. Flag can 
take on the same values as in foreground above. Returns the old terse flag. Default is 
no change. 
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unalias(aiias) 

Undefine alias. Returns -1 if alias does not exist, 0 otherwise. 

u nset ( variab le ) 

Undefine variable. Returns -1 if variable does not exist, 0 otherwise. 

variables() 

No arguments. List all variables. No value is returned. 

window([rowJ, [column], [nrow], [ncol], [nline], [frame], 

[pty], [mapnl], [shell]) 

Open a window with upper left corner at row, column and size nrow, ncol. If nline is 
specified, then that many lines are allocated for the text buffer. Otherwise, the default 
buffer size is used. Default values for row , column , nrow, and ncol are, respectively, 
the upper, left-most, lower, or right-most extremes of the screen. Frame, pty, and 
mapnl are flag values interpreted in the same way as the argument to foreground (see 
above); they mean, respectively, put a frame around this window (default true), allo¬ 
cate pseudo-terminal for this window rather than socketpair (default true), and map 
new line characters in this window to carriage return and line feed (default true if 
socketpair is used, false otherwise). Shell is a list of strings that will be used as the 
shell program to place in the window (default is the program specified by shell, see 
below). The created window’s identifier is returned as a number. 

write([window], [<string-list>]) 

Send the list of strings, <string-list>, to window, separated by spaces but not ter¬ 
minated with a new r line. The strings are actually given to the window as input. No 
value is returned. Default is the current window. 

PREDEFINED VARIABLES 

These variables are for information only. Redefining them does not affect the internal opera¬ 
tion of window. 

baud The baud rate as a number between 50 and 38400. 

modes 

The display modes (reverse video, underline, blinking, graphics) supported by the phy¬ 
sical terminal. The value of modes is the bitwise or of some of the one bit values, 
mjblk, m^grp, m^rev, and m_ul (see below). These values are useful in setting the win¬ 
dow cursors’ modes (see cursormodes above). 

m_blk 

The blinking mode bit. 

m_grp 

The graphics mode bit (not very useful). 

m_rev 

The reverse video mode bit. 
m_ul The underline mode bit. 

ncol The number of columns on the physical screen, 
nrow The number of row's on the physical screen. 

term The terminal type. The standard name, found in the second name field of the 
terminal’s TERMCAP entry, is used. 
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WINDOW (1) 


/ "A 

FILES s . 

'/.windowrc startup command file. 

/dev/[pt]ty[pq]? pseudo-terminal devices. 

DIAGNOSTICS 

Should be self explanatory. 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ tty name ] 

DESCRIPTION 

Write copies lines from your terminal to that of another user. When first called, it sends the 
message 

Message from yoursystemlyourname yourttyname... 

The recipient of the message should write back at this point. Communication continues until 
an end of file is read from the terminal or an interrupt is sent. At that point write writes 
‘EOT’ on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the ttyname argument may be 
used to indicate the appropriate terminal name. 

Permission to write may be denied or granted by use of the mesg command. At the outset 
writing is allowed. Certain commands, in particular nroff and pr(l) disallow messages in 
order to prevent messy output. 

If the character T is found at the beginning of a line, write calls the shell to execute the rest 
of the line as a command. 

The following protocol is suggested for using write: when you first write to another user, wait 
for him to write back before starting to send. Each party should end each message with a 
distinctive signal— (o) for ‘over’ is conventional—that the other may reply, (oo) for ‘over 
and out’ is suggested when conversation is about to be terminated. 


FILES 

/etc/utmp to find user 
/bin/sh to execute T 


SEE ALSO 

mesg(l), who(l), mail(l) 
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NAME 

xsend, xget, enroll - secret mail 

SYNOPSIS 

xsend person 

xget 

enroll 

DESCRIPTION 

These commands implement a secure communication channel; it is like mail(l), but no one 
can read the messages except the intended recipient. The method embodies a public-key cryp¬ 
tosystem using knapsacks. 

To receive messages, use enroll ; it asks you for a password that you must subsequently quote 
in order to receive secret mail. 

To receive secret mail, use xget. It asks for your password, then gives you the messages. 

To send secret mail, use xsend in the same manner as the ordinary mail command. (However, 
it will accept only one target). A message announcing the receipt of secret mail is also sent by 
ordinary mail. 


FILES 

/ usr / spool / secretin ail/*.key: keys 
/ usr/spool / secret mail/*. [0-9]: messages 

SEE ALSO 

mail (1) 


BUGS 

It should be integrated with ordinary mail. The announcement of secret mail makes traffic 
analysis possible. 
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NAME 

xstr - extract strings from C programs to implement shared strings 

SYNOPSIS 

xstr [ -c ] [ — ] [ file ] 

DESCRIPTION 

Xstr maintains a file strings into which strings in component parts of a large program are 
hashed. These strings are replaced with references to this common area. This serves to imple¬ 
ment shared constant strings, most useful if they are also read-only. 

The command 

xstr —c name 

will extract the strings from the C source in name, replacing string references by expressions 
of the form (&xstr[number]) for some number. An appropriate declaration of xstr is 
prepended to the file. The resulting C text is placed in the file x.c, to then be compiled. The 
strings from this file are placed in the strings data base if they are not there already. 
Repeated strings and strings which are suffices of existing strings do not cause changes to the 
data base. 

After all components of a large program have been compiled a file xs.c declaring the common 
xstr space can be created by a command of the form 

xstr 

This xs.c file should then be compiled and loaded with the rest of the program. If possible, 
the array can be made read-only (shared) saving space and swap overhead. 

Xstr can also be used on a single file. A command 
xstr name 

creates files x.c and xs.c as before, without using or affecting any strings file in the same direc¬ 
tory. 

It may be useful to run xstr after the C preprocessor if any macro definitions yield strings or if 
there is conditional code which contains strings which may not, in fact, be needed. Xstr reads 
from its standard input when the argument is given. An appropriate command sequence 
for running xstr after the C preprocessor is: 

cc -E name.c | xstr -c - 
cc -c x.c 
mv x.o name.o 

Xstr does not touch the file strings unless new items are added, thus make can avoid remaking 
xs.o unless truly necessary. 


FILES 

strings 

x.c 

xs.c 

/tmp/xs* 


Data base of strings 

Massaged C source 

C source for definition of array ‘xstr’ 

Temp file when ‘xstr name’ doesn’t touch strings 


SEE ALSO 

mkstr(l) 
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AUTHOR 

William Joy 


BUGS 

If a string is a suffix of another string in the data base, but the shorter string is seen first by 
xstr both strings will be placed in the data base, when just placing the longer one there will 
do. 
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YACC (1) 


NAME 

yacc - yet another compiler-compiler 

SYNOPSIS 

yacc [ —vd ] grammar 

DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple automaton which exe¬ 
cutes an LR(l) parsing algorithm. The grammar may be ambiguous; specified precedence 
rules are used to break ambiguities. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program yypar. se. 
This program must be loaded with the lexical analyzer program, yylex, as well as main and 
yyerror, an error handling routine. These routines must be supplied by the user; Lex{ 1) is 
useful for creating lexical analyzers usable by yacc. 

If the —v flag is given, the file y.output is prepared, which contains a description of the parsing 
tables and a report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the define statements that associate the 
yacc-assigned ‘token codes’ with the user-declared ‘token names’. This allows source files 
other than y.tab.c to access the token codes. 


FILES 

y.output 
y.tab.c 

y.tab.h defines for token names 

yacc.tmp, yacc.acts temporary files 
/usr/lib/yaccpar parser prototype for C programs 

SEE ALSO 

lex( 1) 

LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 

YACC - Yet Another Compiler Compiler by S. C. Johnson. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is reported on the standard output; a 
more detailed report is found in the y.output file. Similarly, if some rules are not reachable 
from the start symbol, this is also reported. 

BUGS 

Because file names are fixed, at most one yacc process can be active in a given directory at a 
time. 
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NAME 

yes - be repetitively affirmative 

SYNOPSIS 

yes [ expletive ] 

DESCRIPTION 

Yes repeatedly outputs “y”, or if expletive is given, that is output repeatedly. Termination is 
by rubout. 


ICON INTERNATIONAL 


1 



SECTION 2 


ICON/UXB 

OPERATING 


SYSTEM 

CALLS 









INTRO (2) 


SYSTEM CALLS 


INTRO (2) 


NAME 

intro - introduction to system calls and error numbers 

SYNOPSIS 

^include <errno.h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or more error 
returns. An error condition is indicated by an otherwise impossible return value. This is 
almost always -1; the individual descriptions specify the details. 

As with normal arguments, all return codes and values from functions are of type integer 
unless otherwise noted. An error number is also made available in the external variable errno, 
which is not cleared on successful calls. Thus errno should be tested only after an error has 
occurred. 

The following is a complete list of the errors and their names as given in <errno.h>. 

0 "Error 0 
Unused. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a file in some way forbidden except 
to its owner or super-user. It is also returned for attempts by ordinary users to do 
things allowed only to the super-user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file should exist but doesn’t, or 
when one of the directories in a path name does not exist. 

3 ESRCH No such process 

The process whose number was given to kill and ptrace does not exist, or is already 
dead. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), which the user has elected to 
catch, occurred during a system call. If execution is resumed after processing the sig¬ 
nal, it will appear as if the interrupted system call returned this error condition. 

5 ElO I/O error 

Some physical I/O error occurred during a read or write. This error may in some cases 
occur on a call following the one to which it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which does not exist, or beyond the limits of 
the device. It may also occur when, for example, an illegal tape drive unit number is 
selected or a disk pack is not loaded on a drive. 

7 E2BIG Arg list too long 

An argument list longer than 10240 bytes is presented to execve. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it has the appropriate permissions, 
does not start with a valid magic number, see a.out( 5). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file, or a read (resp. write) request is made to 
a file which is open only for writing (resp. reading). 
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26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program which is currently open for writing 
(or reading!). Also an attempt to open for writing a pure-procedure program that is 
being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum (about 10 9 bytes). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. This error may also be issued for other non-seekable 
devices. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a device mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than 32767 hard links to a file. 

32 EPIPE Broken pipe 

A write on a pipe or socket for which there is no process to read the data. This condi¬ 
tion normally generates a signal; the error is returned if the signal is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is out of the domain of the 
function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is unrepresentable within machine 
precision. 

35 EWOULDBLOCK Operation would block 

An operation which would cause a process to block was attempted on a object in non- 
blocking mode (see ioctl (2)). 

36 EINPROGRESS Operation now in progress 

An operation which takes a long time to complete (such as a connect (2)) was 
attempted on a non-blocking object (see ioctl (2)). 

37 EALREADY Operation already in progress 

An operation was attempted on a non-blocking object which already had an operation 
in progress. 

38 ENOTSOCK Socket operation on non-socket 

Self-explanatory. 

39 EDESTADDRREQ Destination address required 

A required address was omitted from an operation on a socket. 

40 EMSGSIZE Message too long 

A message sent on a socket was larger than the internal message buffer. 

41 EPROTOTYPE Protocol wrong type for socket 

A protocol was specified which does not support the semantics of the socket type 
requested. For example you cannot use the ARP A Internet UDP protocol with type 
SOCK_STREAM. 
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10 ECHILD No children 

Wait and the process has no living or unwaited-for children. 

11 EAGAIN No more processes 

In a fork, the system’s process table is full or the user is not allowed to create any 
more processes. 

12 ENOMEM Not enough core 

During an execve or break, a program asks for more core or swap space than the sys¬ 
tem is able to supply. A lack of swap space is normally a temporary condition, how¬ 
ever a lack of core is not a temporary condition; the maximum size of the text, data, 
and stack segments is a system parameter. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protection system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting to access the arguments of a 
system call. 

15 ENOTBLK Block device required 

A plain file was mentioned where a block device was required, e.g. in mount. 

16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted or an attempt was made to 
dismount a device on w'hich there is an active file directory, (open file, current direc¬ 
tory, mounted-on file, active text segment). 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g. link. 

18 EXDEV Cross-device link 

A hard link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system call to a device; e.g. 
write-only device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for example in 
name or as an argument to chdir. 

21 EISDIR Is a directory 

An attempt to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument: dismounting a non-mounted device, mentioning an unknown 
signal in signal, reading or writing a file for which seek has generated a negative 
pointer. Also set by math functions, see intro(3). 

23 ENFILE File table overflow 

The system’s table of open files is full, and temporarily no more opens can be accepted. 


read a 


a path 


24 EMFILE Too many open files 

Customary configuration limit is 20 per process. 

25 ENOTTY Not a typewriter 

The file mentioned in an ioctl is not a terminal or one of the other devices to which 
these calls apply. 
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59 unused 

60 ETIMEDOUT Connection timed out 

A connect request failed because the connected party did not properly respond after a 
period of time. (The timeout period is dependent on the communication protocol.) 

61 ECONNREFUSED Connection refused 

No connection could be made because the target machine actively refused it. This 
usually results from trying to connect to a service which is inactive on the foreign 
host. 

62 ELOOP Too many levels of symbolic links 

A path name lookup involved more than 8 symbolic links. 

63 ENAMETOOLONG File name too long 

A component of a path name exceeded 255 characters, or an entire path name 
exceeded 1023 characters. 

64 EHOSTDOWN Host is down 

A socket operation failed because the destination host was down. 

65 EHOSTUNREACH Host is unreachable 

A socket operation was attempted to an unreachable host. 

66 ENOTEMPTY Directory not empty 

A directory with entries other than and was supplied to a remove directory or 
rename call. 

69 EDQUOT Disc quota exceeded 

70 ENOTREG (used internally) 

71 ECTNRDY Cassette tape not ready 

72 ENOMSG No message of desired type 

73 EIDRM Identifier removed 

74 EDEADLK Deadlock condition if locked 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by a positive integer called a 
process ID. The range of this ID is from 0 to {PROC_MAX}. 

Parent process ID 

A new process is created by a currently active process; see fork( 2). The parent process 
ID of a process is the process ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is identified by a positive 
integer called the process group ID. This is the process ID of the group leader. This 
grouping permits the signalling of related processes (see killpg(2 )) and the job control 
mechanisms of csA(l). 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a positive 
integer called the tty group ID. This grouping is used to arbitrate between multiple 
jobs contending for the same terminal; see cs/i(l), and tty(4). 
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42 ENOPROTOOPT Bad protocol option 

A bad option was specified in a getsockopt( 2) or setsockopt( 2) call. 

43 EPROTONOSUPPORT Protocol not supported 

The protocol has not been configured into the system or no implementation for it 
exists. 

44 ESOCKTNOSUPPORT Socket type not supported 

The support for the socket type has not been configured into the system or no imple¬ 
mentation for it exists. 

45 EOPNOTSUPP Operation not supported on socket 

For example, trying to accept a connection on a datagram socket. 

46 EPFNOSUPPORT Protocol family not supported 

The protocol family has not been configured into the system or no implementation for 
it exists. 

47 EAFNOSUPPORT Address family not supported by protocol family 

An address incompatible with the requested protocol was used. For example, you 
shouldn’t necessarily expect to be able to use PUP Internet addresses with ARPA 
Internet protocols. 

48 EADDRINUSE Address already in use 

Only one usage of each address is normally permitted. 

49 EADDRNOTAVAIL Can’t assign requested address 

Normally results from an attempt to create a socket with an address not on this 
machine. 

50 ENETDOWN Network is down 

A socket operation encountered a dead network. 

51 ENETUNREACH Network is unreachable 

A socket operation was attempted to an unreachable network. 

52 ENETRESET Network dropped connection on reset 

The host you were connected to crashed and rebooted. 

53 ECONNABORTED Software caused connection abort 

A connection abort was caused internal to your host machine. 

54 ECONNRESET Connection reset by peer 

A connection was forcibly closed by a peer. This normally results from the peer exe¬ 
cuting a shutdown (2) call. 

55 ENOBUFS No buffer space available 

An operation on a socket or pipe was not performed because the system lacked 
sufficient buffer space. 

56 EISCONN Socket is already connected 

A connect request was made on an already connected socket; or, a sendto or sendmsg 
request on a connected socket specified a destination other than the connected party. 

57 ENOTCONN Socket is not connected 

An request to send or receive data was disallowed because the socket is not connected. 

58 ESHUTDOWN Can’t send after socket shutdown 

A request to send data was disallowed because the socket had already been shut dow'n 
with a previous shutdown( 2) call. 
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Root Directory and Current Working Directory 

Each process has associated with it a concept of a root directory and a current working 
directory for the purpose of resolving path name searches. A process’s root directory 
need not be the root directory of the root file system. 

File Access Permissions 

Every file in the file system has a set of access permissions. These permissions are used 
in determining whether a process may perform a requested operation on the file (such as 
opening a file for writing). Access permissions are established at the time a file is 
created. They may be changed at some later time through the chmod( 2) call. 

File access is broken down according to whether a file may be: read, written, or exe¬ 
cuted. Directory files use the execute permission to control if the directory may be 
searched. 

File access permissions are interpreted by the system as they apply to three different 
classes of users: the owner of the file, those users in the file’s group, anyone else. Every 
file has an independent set of access permissions for each of these classes. When an 
access check is made, the system decides if permission should be granted by checking the 
access information applicable to the caller. 

Read, write, and execute/search permissions on a file are granted to a process if: 

The process’s effective user ID is that of the super-user. 

The process’s effective user ID matches the user ID of the owner of the file and the 
owner permissions allow the access. 

The process’s effective user ID does not match the user ID of the owner of the file, and 
either the process’s effective group ID matches the group ID of the file, or the group ID 
of the file is in the process’s group access list, and the group permissions allow the 
access. 

Neither the effective user ID nor effective group ID and group access list of the process 
match the corresponding user ID and group ID of the file, but the permissions for “other 
users” allow access. 

Otherwise, permission is denied. 

Sockets and Address Families 

A socket is an endpoint for communication between processes. Each socket has queues 
for sending and receiving data. 

Sockets are typed according to their communications properties. These properties 
include whether messages sent and received at a socket require the name of the partner, 
whether communication is reliable, the format used in naming message recipients, etc. 

Each instance of the system supports some collection of socket types; consult socket( 2) 
for more information about the types available and their properties. 

Each instance of the system supports some number of sets of communications protocols. 
Each protocol set supports addresses of a certain format. An Address Family is the set 
of addresses for a specific group of protocols. Each socket has an address chosen from 
the address family in which the socket was created. 


SEE ALSO 

intro(3), perror(3) 
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Real User ID and Real Group ID 

Each user on the system is identified by a positive integer termed the real user ID. 

Each user is also a member of one or more groups. One of these groups is distinguished 
from others and used in implementing accounting facilities. The positive integer 
corresponding to this distinguished group is termed the real group ID. 

All processes have a real user ID and real group ID. These are initialized from the 
equivalent attributes of the process which created it. 

Effective User Id, Effective Group Id, and Access Groups 

Access to system resources is governed by three values: the effective user ID, the effective 
group ID, and the group access list. 

The effective user ID and effective group ID are initially the process’s real user ID and 
real group ID respectively. Either may be modified through execution of a set-user-ID or 
set-group-ID file (possibly by one its ancestors); see execve( 2). 

The group access list is an additional set of group ID’s used only in determining resource 
accessibility. Access checks are performed as described below in “File Access Permis¬ 
sions”. 

Super-user 

A process is recognized as a super-user process and is granted special privileges if its 
effective user ID is 0. 

Special Processes 

The processes with a process ID’s of 0, 1, and 2 are special. Process 0 is the scheduler. 
Process 1 is the initialization process init, and is the ancestor of every other process in 
the system. It is used to control the process structure. 

Descriptor 

An integer assigned by the system when a file is referenced by open( 2), dup( 2), or pipe{ 2) 
or a socket is referenced by socket( 2) or socketpair( 2) which uniquely identifies an access 
path to that file or socket from a given process or any of its children. 

File Name 

Names consisting of up to {FILENAME_MAX} characters may be used to name an ordi¬ 
nary file, special file, or directory. 

These characters may be selected from the set of all ASCII character excluding 0 (null) 
and the ASCII code for / (slash). (The parity bit, bit 8, must be 0.) 

Note that it is generally unwise to use *, ?, [ or J as part of file names because of the spe¬ 
cial meaning attached to these characters by the shell. 

Path Name 

A path name is a null-terminated character string starting with an optional slash (/), 
followed by zero or more directory names separated by slashes, optionally followed by a 
file name. The total length of a path name must be less than {PATHNAME_MAX} 
characters. 

If a path name begins with a slash, the path search begins at the root directory. Other¬ 
wise, the search begins from the current working directory. A slash by itself names the 
root directory. A null pathname refers to the current directory. 

Directory 

A directory is a special type of file which contains entries which are references to other 
files. Directory entries are called links. By convention, a directory contains at least two 
links, . and .., referred to as dot and dot-dot respectively. Dot refers to the directory 
itself and dot-dot refers to its parent directory. 
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NAME 

accept - accept a connection on a socket 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/socket.h> 

ns = accept(s, addr, addrlen) 
int ns, s; 

struct sockaddr *addr; 
int *addrlen; 

DESCRIPTION 

The argument s is a socket which has been created with socket[ 2), bound to an address with 
bind(2), and is listening for connections after a listen(2). Accept extracts the first connection 
on the queue of pending connections, creates a new socket with the same properties of s and 
allocates a new file descriptor, ns, for the socket. If no pending connections are present on the 
queue, and the socket is not marked as non-blocking, accept blocks the caller until a connec¬ 
tion is present. If the socket is marked non-blocking and no pending connections are present 
on the queue, accept returns an error as described below. The accepted socket, ns, may not 
be used to accept more connections. The original socket s remains open. 

The argument addr is a result parameter which is filled in with the address of the connecting 
entity, as known to the communications layer. The exact format of the addr parameter is 
determined by the domain in which the communication is occurring. The addrlen is a value- 
result parameter; it should initially contain the amount of space pointed to by addr; on return 
it will contain the actual length (in bytes) of the address returned. This call is used with 
connection-based socket types, currently with SOCK_STREAM. 

It is possible to select( 2) a socket for the purposes of doing an accept by selecting it for read. 

RETURN VALUE 

The call returns -1 on error. If it succeeds it returns a non-negative integer which is a 
descriptor for the accepted socket. 

ERRORS 

The accept will fail if: 

[EBADF] 

[ENOTSOCIC] 

[EOPNOTSUPP] 

[EFAULT] 

[EWOULDBLOCK] 


The descriptor is invalid. 

The descriptor references a file, not a socket. 

The referenced socket is not of type SOCK_STREAM. 

The addr parameter is not in a writable part of the user address space. 

The socket is marked non-blocking and no connections are present to 
be accepted. 


SEE ALSO 

bind(2), connect(2), listen(2), select(2), socket(2) 
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NAME 

access - determine accessibility of file 


SYNOPSIS 

^include <sys/file.h> 


#define R_OK 4 
#define W_OK 2 
^define XL_OK 1 
#define F_OK 0 


/* test for read permission */ 

/* test for write permission */ 

/* test for execute (search) permission */ 
/* test for presence of file */ 


accessible = access (path, mode) 
int accessible; 
char *path; 
int mode; 


DESCRIPTION 

Access checks the given file path for accessibility according to mode, which is an inclusive or of 
the bits R_OK, W_OIv and X_OK. Specifying mode as F_OIv (i.e. 0) tests whether the direc¬ 
tories leading to the file can be searched and the file exists. 

The real user ID and the group access list (including the real group ID) are used in verifying 
permission, so this call is useful to set-UID programs. 

Notice that only access bits are checked. A directory may be indicated as writable by access, 
but an attempt to open it for writing will fail (although files may be created there); a file may 
look executable, but execve will fail unless it is in proper format. 

RETURN VALUE 

If path cannot be found or if any of the desired access modes would not be granted, then a -1 
value is returned; otherwise a 0 value is returned. 


ERRORS 

Access to the file is denied if one or more of the following are true: 


[ENOTDIR] 

[ENOENT] 

[ENOENT] 

[EPERM] 

[ELOOP] 

[EROFS] 

[ETXTBSY] 

[EACCES] 


[EFAULT] 


A component of the path prefix is not a directory. 

The argument path name was too long. 

Read, write, or execute (search) permission is requested for a null path name 
or the named file does not exist. 

The argument contains a byte with the high-order bit set. 

Too many symbolic links were encountered in translating the pathname. 
Write access is requested for a file on a read-only file system. 

Write access is requested for a pure procedure (shared text) file that is being 
executed. 

Permission bits of the file mode do not permit the requested access; or search 
permission is denied on a component of the path prefix. The owner of a file 
has permission checked with respect to the “owner” read, write, and execute 
mode bits, members of the file’s group other than the owner have permission 
checked with respect to the “group” mode bits, and all others have permis¬ 
sions checked with respect to the “other” mode bits. 

Path points outside the process’s allocated address space. 
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SEE ALSO 

chmod(2), stat(2) 
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SYSTEM CALLS 


ACCT (2) 


NAME 

acct - turn accounting on or off 

SYNOPSIS 

acct(file) 

char 

DESCRIPTION 

The system is prepared to write a record in an accounting file for each process as it ter¬ 
minates. This call, with a null-terminated string naming an existing file as argument, turns 
on accounting; records for each terminating process are appended to file. An argument of 0 
causes accounting to be turned off. 

The accounting file format is given in acct{ 5). 

This call is permitted only to the super-user. 

NOTES 

Accounting is automatically disabled when the file system the accounting file resides on runs 
out of space; it is enabled when space once again becomes available. 

RETURN VALUE 

On error -1 is returned. The file must exist and the call may be exercised only by the super- 
user. It is erroneous to try to turn on accounting when it is already on. 


ERRORS 

Acct will fail if one of the following is true: 


[EPERM] 

[EPERM] 

[ENOTDIR] 

[ENOENT] 

[EISDIR] 

[EROFS] 

[EFAULT] 

[ELOOP] 

[EACCES] 

SEE ALSO 

acct(5), sa(8) 


The caller is not the super-user. 

The pathname contains a character with the high-order bit set. 

A component of the path prefix is not a directory. 

The named file does not exist. 

The named file is a directory. 

The named file resides on a read-only file system. 

File points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
The file is a character or block special file. 


BUGS 

No accounting is produced for programs running when a crash occurs. In particular nonter¬ 
minating programs are never accounted for. 
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BIND (2) 


NAME 

bind - bind a name to a socket 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/socket.h> 

bind(s, name, namelen) 
int s; 

struct sockaddr *name; 
int namelen; 

DESCRIPTION 

Bind assigns a name to an unnamed socket. When a socket is created with socket( 2) it exists 
in a name space (address family) but has no name assigned. Bind requests the name, be 
assigned to the socket. 

NOTES 

Binding a name in the UNIX domain creates a socket in the file system which must be deleted 
by the caller when it is no longer needed (using unlink( 2)). The file created is a side-effect of 
the current implementation, and will not be created in future versions of the UNIX ipc 
domain. 

The rules used in name binding vary between communication domains. Consult the manual 
entries in section 4 for detailed information. 

RETURN VALUE 

If the bind is successful, a 0 value is returned. A return value of -1 indicates an error, which 
is further specified in the global errno. 

ERRORS 

The bind call will fail if: 

[EBADF] S is not a valid descriptor. 

[ENOTSOCK] S is not a socket. 

[EADDRNOTAVAIL] The specified address is not available from the local machine. 
[EADDRINUSE] The specified address is already in use. 

[EINVAL] The socket is already bound to an address. 

[EACCESS] The requested address is protected, and the current user has inadequate 

permission to access it. 

[EFAULT] The name parameter is not in a valid part of the user address space. 

SEE ALSO 

connect(2), listen(2), socket(2), getsockname(2) 
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NAME 

brk, sbrk - change data segment size 

SYNOPSIS 

caddr_t brk(addr) 
caddr_t addr; 

caddr_t sbrk(incr) 
int incr; 

DESCRIPTION 

Brk sets the system’s idea of the lowest data segment location not used by the program (called 
the break) to addr (rounded up to the next multiple of the system’s page size). Locations 
greater than addr and below the stack pointer are not in the address space and will thus cause 
a memory violation if accessed. 

In the alternate function sbrk, incr more bytes are added to the program’s data space and a 
pointer to the start of the new area is returned. 

When a program begins execution via execve the break is set at the highest location defined by 
the program and data storage areas. Ordinarily, therefore, only programs with growing data 
areas need to use sbrk. 

The getrlimit( 2) system call may be used to determine the maximum permissible size of the 
data segment; it will not be possible to set the break beyond the rlim_max value returned 
from a call to getrlimit, e.g. “etext + rip—►rlim_max.” (See end( 3) for the definition of etext.) 

RETURN VALUE 

Zero is returned if the brk could be set; -1 if the program requests more memory than the sys¬ 
tem limit. Sbrk returns -1 if the break could not be set. 

ERRORS 

Sbrk will fail 

[ENOMEM] 

[ENOMEM] 

[ENOMEM] 

SEE ALSO 

execve(2), getrlimit(2), malloc(3), end(3) 


and no additional memory will be allocated if one of the following are true: 

The limit, as set by setrlim.it { 2), was exceeded. 

The maximum possible size of a data segment (compiled into the system) 
was exceeded. 

Insufficient space existed in the swap area to support the expansion. 


BUCJS 

Setting the break may fail due to a temporary lack of swap space. It is not possible to distin¬ 
guish this from a failure caused by exceeding the maximum size of the data segment without 
consulting getrlimit. 
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CHDIR (2) 


NAME 

chdir - change current working directory 

SYNOPSIS 

chdir(path) 
char *path; 

DESCRIPTION 

Path is the pathname of a directory. Chdir causes this directory to become the current work¬ 
ing directory, the starting point for path names not beginning with “/”. 

In order for a directory to become the current directory, a process must have execute (search) 
access to the directory. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Chdir will fail and the current working directory will be unchanged if one or more of the fol¬ 
lowing are true: 

[ENOTDIR] 

[ENOENT] 

[ENOENT] 

[EPERM] 

[EACCES] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

chroot(2) 


A component of the pathname is not a directory. 

The named directory does not exist. 

The argument path name was too long. 

The argument contains a byte with the high-order bit set. 

Search permission is denied for any component of the path name. 

Path points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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SYSTEM CALLS 


CHMOD (2) 


NAME 

chmod - change mode of file 

SYNOPSIS 

chmod(path, mode) 
char *path; 
int mode; 

fchmod(fd, mode) 
int fd, mode; 

DESCRIPTION 

The file whose name is given by path or referenced by the descriptor fd has its mode changed 
to mode. Modes are constructed by or’ing together some combination of the following: 

04000 set user ID on execution 
02000 set group ID on execution 
01000 save text image after execution 
00400 read by owner 
00200 write by owner 

00100 execute (search on directory) by owner 
00070 read, write, execute (search) by group 
00007 read, write, execute (search) by others 

If an executable file is set up for sharing (this is the default) then mode 1000 prevents the sys¬ 
tem from abandoning the swap-space image of the program-text portion of the file when its 
last user terminates. Ability to set this bit is restricted to the super-user. 

Only the owner of a file (or the super-user) may change the mode. 

Writing or changing the owner of a file turns off the set-user-id and set-group-id bits. This 
makes the system somewhat more secure by protecting set-user-id (set-group-id) files from 
remaining set-user-id (set-group-id) if they are modified, at the expense of a degree of compati¬ 
bility. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


ERRORS 

Chmod will fail 

[EPERM] 

[ENOTDIR] 

[ENOENT] 

[ENOENT] 

[EACCES] 

[EPERM] 

[EROFS] 

[EFAULT] 

[ELOOP] 


and the file mode will be unchanged if: 

The argument contains a byte with the high-order bit set. 

A component of the path prefix is not a directory. 

The pathname was too long. 

The named file does not exist. 

Search permission is denied on a component of the path prefix. 

The effective user ID does not match the owner of the file and the effective 
user ID is not the super-user. 

The named file resides on a read-only file system. 

Path points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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Fchmod will fail if: 

[EBADF] The descriptor is not valid. 

[EINVAL] Fd refers to a socket, not to a file. 

[EROFS] The file resides on a read-only file system. 

SEE ALSO 

open(2), chown(2) 
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CHOWN (2) 


NAME 

chown - change owner and group of a file 

SYNOPSIS 

chown(path, owner, group) 

char *path; 

int owner, group; 

fchown(fd, owner, group) 
int fd, owner, group; 

DESCRIPTION 

The file which is named by path or referenced by fd has its owner and group changed as 
specified. Only the super-user may execute this call, because if users were able to give files 
away, they could defeat the file-space accounting procedures. 

On some systems, chown clears the set-user-id and set-group-id bits on the file to prevent 
accidental creation of set-user-id and set-group-id programs owned by the super-user. 

Fchown is particularly useful when used in conjunction with the file locking primitives (see 
flock{2)). 

Only one of the owner and group id’s may be set by specifying the other as -1. 

RETURN VALUE 

Zero is returned if the operation was successful; -1 is returned if an error occurs, with a more 
specific error code being placed in the global variable errno. 


ERRORS 

Chown will fail and the file will be unchanged if: 

[EINVAL] The argument path does not refer to a file. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The argument pathname is too long. 

[EPERM] The argument contains a byte with the high-order bit set. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the path prefix. 

[EPERM] The effective user ID does not match the owner of the file and the effective 

user ID is not the super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

Fchown will fail if: 

[EBADF] Fd does not refer to a valid descriptor. 

[EINVAL] Fd refers to a socket, not a file. 


SEE ALSO 

chmod(2), flock(2) 
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CHROOT(2) 


NAME 

chroot - change root directory 

SYNOPSIS 

chroot(dirname) 
char *dirname; 

DESCRIPTION 

Dirname is the address of the pathname of a directory, terminated by a null byte. Chroot 
causes this directory to become the root directory, the starting point for path names begin¬ 
ning with “/”. 

In order for a directory to become the root directory a process must have execute (search) 
access to the directory. 

This call is restricted to the super-user. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate an error. 

ERRORS 

Chroot will fail 
true: 

[ENOTDIR] 

[ENOENT] 

[EPERM] 

[ENOENT] 

[EACCES] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

chdir(2) 


and the root directory will be unchanged if one or more of the following are 

A component of the path name is not a directory. 

The pathname was too long. 

The argument contains a byte with the high-order bit set. 

The named directory does not exist. 

Search permission is denied for any component of the path name. 

Path points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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NAME 

close - delete a descriptor 

SYNOPSIS 

close(d) 
int d; 

DESCRIPTION 

The close call deletes a descriptor from the per-process object reference table. If this is the 
last reference to the underlying object, then it will be deactivated. For example, on the last 
close of a file the current seek pointer associated with the file is lost; on the last close of a 
socket{ 2) associated naming information and queued data are discarded; on the last close of a 
file holding an advisory lock the lock is released; see further flock{2). 

A close of all of a process’s descriptors is automatic on exit , but since there is a limit on the 
number of active descriptors per process, close is necessary for programs which deal with 
many descriptors. 

When a process forks (see fork( 2)), all descriptors for the new child process reference the same 
objects as they did in the parent before the fork. If a new process is then to be run using 
execve( 2), the process would normally inherit these descriptors. Most of the descriptors can be 
rearranged with dupS( 2) or deleted with close before the execve is attempted, but if some of 
these descriptors will still be needed if the execve fails, it is necessary to arrange for them to 
be closed if the execve succeeds. For this reason, the call “fcntl(d, F_SETFD, 1)” is provided 
which arranges that a descriptor will be closed after a successful execve; the call <; fcntl(d, 
F_SETFD, 0)” restores the default, which is to not close the descriptor. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
the global integer variable errno is set to indicate the error. 

ERRORS 

Close will fail if: 

[EBADF] D is not an active descriptor. 

SEE ALSO 

accept(2), flock(2), open(2), pipe(2), socket(2), socketpair(2), execve(2), fcntl(2) 
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CONNECT(2) 


NAME 

connect - initiate a connection on a socket 


SYNOPSIS 

•^include <sys/types.h> 

#include <sys/socket.h> 

connect(s, name, namelen) 
int s; 

struct sockaddr *name; 
int namelen; 

DESCRIPTION 

The parameter s is a socket. If it is of type SOCKJDGRAM, then this call permanently 
specifies the peer to which datagrams are to be sent; if it is of type SOCKJSTREAM, then 
this call attempts to make a connection to another socket. The other socket is specified by 
name which is an address in the communications space of the socket. Each communications 
space interprets the name parameter in its own way. 

RETURN VALUE 

If the connection or binding succeeds, then 0 is returned. Otherwise a -1 is returned, and a 
more specific error code is stored in errno. 


ERRORS 

The call fails if: 

[EBADF] S is not a valid descriptor. 

[ENOTSOCK] S is a descriptor for a file, not a socket. 

[EADDRNOTAVAIL] The specified address is not available on this machine. 

[EAFNOSUPPORT] Addresses in the specified address family cannot be used with this 

socket. 


[EISCONN] 

[ETIMEDOUT] 

[ECONNREFUSED] 

[ENETUNREACH] 

[EADDRINUSE] 

[EFAULT] 

[EWOULDBLOCK] 


The socket is already, connected. 

Connection establishment timed out without establishing a connection. 
The attempt to connect was forcefully rejected. 

The network isn’t reachable from this host. 

The address is already in use. 

The name parameter specifies an area outside the process address 
space. 

The socket is non-blocking and the and the connection cannot be com¬ 
pleted immediately. It is possible to select( 2) the socket while it. is con¬ 
necting by selecting it for writing. 


SEE ALSO 

accept(2), select(2), socket(2), getsockname(2) 
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CREAT(2) 


NAME 

creat - create a new file 


SYNOPSIS 

creat(name, mode) 
char *name; 


DESCRIPTION 

Thb interface b obsoleted by open (2). 

Creat creates a new file or prepares to rewrite an existing file called name , given as the 
address of a null-terminated string. If the file did not exist, it is given mode mode, as 
modified by the process’s mode mask (see umask( 2)). Also see chmod( 2) for the construction 
of the mode argument. 

If the file did exist, its mode and owner remain unchanged but it is truncated to 0 length. 

The file is also opened for writing, and its file descriptor is returned. 

NOTES 

The mode given is arbitrary; it need not allow writing. This feature has been used in the past 
by programs to construct a simple exclusive locking mechanism. It is replaced by the 
0_EXCL open mode, or flock( 2) facilitity. 

RETURN VALUE 

The value -1 is returned if an error occurs. Otherwise, the call returns a non-negative 
descriptor which only permits writing. 


ERRORS 

Creat will fail and the file will not be created or truncated if one of the following occur: 


[EPERM] 
[ENOTDIR] 
[EACCES] 
[EACCES] 

[EACCES] 
[EISDIR] 
[EMFILE] 
[EROFS] 
[ENXIO] 

[ETXTBSY] 
[EFAULT] 
[ELOOP] 
[EOPNOTSUPP] 


The argument contains a byte with the high-order bit set. 

A component of the path prefix is not a directory. 

A needed directory does not have search permission. 

The file does not exist and the directory in which it is to be created is not 
writable. 

The file exists, but it is unwritable. 

The file is a directory. 

There are already too many files open. 

The named file resides on a read-only file system. 

The file is a character special or block special file, and the associated device 
does not exist. 

The file is a pure procedure (shared text) file that is being executed. 

Name points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 

The file was a socket (not currently implemented). 


SEE ALSO 

open(2), write(2), close(2), chmod(2), umask(2) 
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DUP(2) 


NAME 

dup, dup2 - duplicate a descriptor 

SYNOPSIS 

newd == dup(oldd) 
int newd, oldd; 

dup2(oldd, newd) 
int oldd, newd; 

DESCRIPTION 

Dup duplicates an existing object descriptor. The argument oldd is a small non-negative 
integer index in the per-process descriptor table. The value must be less than the size of the 
table, which is returned by getdtablesize( 2). The new descriptor newd returned by the call is 
the lowest numbered descriptor which is not currently in use by the process. 

The object referenced by the descriptor does not distinguish between references using oldd and 
newd in any way. Thus if newd and oldd are duplicate references to an open file, read( 2), 
write(2) and lseek( 2) calls all move a single pointer into the file. If a separate pointer into the 
file is desired, a different object reference to the file must be obtained by issuing an additional 
open(2) call. 

In the second form of the call, the value of newd desired is specified. If this descriptor is 
already in use, the descriptor is first deallocated as if a close( 2) call had been done first. 

RETURN VALUE 

The value -1 is returned if an error occurs in either call. The external variable errno indicates 
the cause of the error. 

ERRORS 

Dup and dup2 fail if: 

[EBADF] Oldd or newd is not a valid active descriptor 

[EMFILE] Too many descriptors are active. 

SEE ALSO 

accept(2), open(2), close(2), pipe(2), socket(2), socketpair(2), getdtablesize(2) 
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SYSTEM CALLS 


EXECVE(2) 


NAME 

execve - execute a file 

SYNOPSIS 

execve(name, argv, envp) 
char *name, *argv[], *envp[|; 

DESCRIPTION 

Execve transforms the calling process into a new process. The new process is constructed from 
an ordinary file called the new process file. This file is either an executable object file, or a file 
of data for an interpreter. An executable object file consists of an identifying header, followed 
by pages of data representing the initial program (text) and initialized data pages. Additional 
pages may be specified by the header to be initialize with zero data. See a.out( 5). 

An interpreter file begins with a line of the form “#! interpreter When an interpreter file is 
execve ’d, the system execve’ s the specified interpreter, giving it the name of the originally 
exec’d file as an argument, shifting over the rest of the original arguments. 

There can be no return from a successful execve because the calling core image is lost. This is 
the mechanism whereby different process images become active. 

The argument argv is an array of character pointers to null-terminated character strings. 
These strings constitute the argument list to be made available to the new process. By con¬ 
vention, at least one argument must be present in this array, and the first element of this 
array should be the name of the executed program (i.e. the last component of name). 

The argument envp is also an array of character pointers to null-terminated strings. These 
strings pass information to the new process which are not directly arguments to the com¬ 
mand, see environ(7). 

Descriptors open in the calling process remain open in the new process, except for those for 
which the close-on-exec flag is set; see close( 2). Descriptors which remain open are unaffected 
by execve. 

Ignored signals remain ignored across an execve, but signals that are caught are reset to their 
default values. The signal stack is reset to be undefined; see sigvec(2) for more information. 

Each process has real user and group IDs and a effective user and group IDs. The real ID 
identifies the person using the system; the effective ID determines his access privileges. Execve 
changes the effective user and group ID to the owner of the executed file if the file has the 
“set-user-ID” or “set-group-ID” modes. The real user ID is not affected. 

The new process also inherits the following attributes from the calling process: 


process ID 

see getpid( 2) 

parent process ID 

see getppid( 2) 

process group ID 

see getpgrp (2) 

access groups 

see getgroups{ 2) 

working directory 

see chdir(2) 

root directory 

see chroot{ 2) 

control terminal 

see tty (4) 

resource usages 

see getrusage{ 2) 

interval timers 

see getitimer(2) 

resource limits 

see getrlimit(2 ) 

file mode mask 

see umask( 2) 

signal mask 

see sigvec(2) 
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execve (2) 


When the executed program begins, it is called as follows: 

main(argc, argv, envp) 
int argc; 

char **argv, **envp; 

where argc is the number of elements in argv (the “arg count”) and argv is the array of char¬ 
acter pointers to the arguments themselves. 

Envp is a pointer to an array of strings that constitute the environment of the process. A 
pointer to this array is also stored in the global variable “environ”. Each string consists of a 
name, an and a null-terminated value. The array of pointers is terminated by a null 

pointer. The shell sh( 1) passes an environment entry for each global shell variable defined 
when the program is called. See environ{l ) for some conventionally used names. 

RETURN VALUE 

If execve returns to the calling process an error has occurred; the return value will be -1 and 
the global variable errno will contain an error code. 


ERRORS 

Execve will fail and return to the calling process if one or more of the following are true: 


[ENOENT] 

[ENOTD1R] 

[EACCES] 

[EACCES] 

[EACCES] 

[ENOEXEC] 

[ETXTBSY] 

[ENOMEM] 

[E2BIG] 

[EFAULT] 


One or more components of the new process file’s path name do not exist. 

A component of the new’ process file is not a directory. 

Search permission is denied for a directory listed in the new' process file’s 
path prefix. 

The new process file is not an ordinary file. 

The new' process file mode denies execute permission. 

The new process file has the appropriate access permission, but has an 
invalid magic number in its header. 

The new process file is a pure procedure (shared text) file that is currently 
open for waiting or reading by some process. 

The new process requires more virtual memory than is allowed by the 
imposed maximum (getrlimit( 2)). 

The number of bytes in the new process’s argument list is larger than the 
system-imposed limit of {ARG_MAX} bytes. 

The new process file is not as long as indicated by the size values in its 
header. 


[EFAULT] Path, argv, or envp point to an illegal address. 


CAVEATS 

If a program is setuid to a non-super-user, but is executed when the real uid is “root”, then 
the program has the powers of a super-user as well. 


SEE ALSO 

exit(2), fork(2), execl(3), environ(7) 
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EXIT (2) 


NAME 

_exit - terminate a process 

SYNOPSIS 

_exit(status) 
int status; 

DESCRIPTION 

_exit terminates a process with the following consequences: 

All of the descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait or is interested in the SIGCHLD 
signal, then it is notified of the calling process’s termination and the low-order eight bits of 
status are made available to it; see wait{ 2). 

The parent process ID of all of the calling process’s existing child processes are also set to 1. 
This means that the initialization process (see mfro(2)) inherits each of these processes as well. 

Most C programs call the library routine exit{ 3) which performs cleanup actions in the stan¬ 
dard i/o library before calling _exit. 

RETURN VALUE 

This call never returns. 

SEE ALSO 

fork(2), wait(2), exit(3) 
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FCNTL (2) 


NAME f 

fcntl - file control v - 

SYNOPSIS 

#include <fcntl.h> 

res = fcntl(fd, cmd, arg) 
int res; 

int fd, cmd, arg; 

DESCRIPTION 

Fcntl provides for control over descriptors. The argument fd is & descriptor to be operated on 
by cmd as follows: 

F_DUPFD Return a new descriptor as follows: 

Lowest numbered available descriptor greater than or equal to arg. 

Same object references as the original descriptor. 

New descriptor shares the same file pointer if the object was a file. 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the same file status 
flags). 

The close-on-exec flag associated with the new file descriptor is set to remain 
open across execv( 2) system calls. 

F_GETFD Get the close-on-exec flag associated with the file descriptor fd. If the low- 
order bit is 0, the file will remain open across exec, otherwise the file will be 
closed upon execution of exec. 

F_SETFD Set the close-on-exec flag associated with fd to the low order bit of arg (0 or 

1 as above). 

F_GETFL Get descriptor status flags, as described below. 

FJSETFL Set descriptor status flags. Only certain flags can be set; see fcntl( 5). 

F_GETOWN Get the process ID or process group currently receiving SIGIO and SIGURG 
signals; process groups are returned as negative values. 

F_SETOWN Set the process or process group to receive SIGIO and SIGURG signals; pro¬ 
cess groups are specified by supplying arg as negative, otherwise arg is inter¬ 
preted as a process ID. 

F_GETLK Get the first lock which blocks the lock description given by the variable of 
type struct flock pointed to by arg. The information retrieved overwrites the 
information passed to fcntl in the flock structure. If no lock is found that 
would prevent this lock from being created, then the structure is passed back 
unchanged except for the lock type which will be set to F_UNLCK. 

FJSETLK Set or clear a file segment lock according to the variable of type struct flock 

pointed to by arg [see fcntl (5)]. The cmd F_SETLIv is used to establish read 
(F_RDLCK) and write (F_WRLCK) locks, as well as remove either type of 
lock (F_UNLCK). If a read or write lock cannot be set. fcntl will return 
immediately with an error value of -1. 
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F_SETLKW This cmd is the same as F_SETLK except that if a read or write lock is 
blocked by other locks, the process will sleep until the segment is free to be 
locked. 

The flags for the F_GETFL and F_SETFL flags are as follows: 

FNDELAY Non-blocking I/O; if no data is available to a read call, or if a write opera¬ 
tion would block, the call returns -1 with the error EWOULDBLOCK. 

FAPPEND Force each write to append at the end of file; corresponds to the 0_APPEND 
flag of open( 2). 

FASYNC Enable the SIGIO signal to be sent to the process group when I/O is possi¬ 

ble, e.g. upon availability of data to be read. 

A read lock prevents any process from write locking the protected area. More than one read 
lock may exist for a given segment of a file at a given time. The file descriptor on which a 
read lock is being placed must have been opened with read access. 

A write lock prevents any process from read locking or write locking the protected area. Only 
one write lock may exist for a given segment of a file at a given time. The file descriptor on 
which a write lock is being placed must have been opened with write access. 

The structure flock describes the type (l_type), starting offset (l_when<e), relative offset 
(Lstart), size (l_len), and process id (Lpid) of the segment of the file to be affected. The pro¬ 
cess id field is only used with the F_GETLK cmd to return the value for a block in lock. 
Locks may start and extend beyond the current end of a file, but may not be negative relative 
to the beginning of the file. A lock may be set to always extend to the end of file by setting 
L len to zero (0). If such a lock also has /_start set to zero (0), the whole file will be locked. 
Changing or unlocking a segment from the middle of a larger locked segment leaves two 
smaller segments for either end. Locking a segment that is already locked by the calling pro¬ 
cess causes the old lock type to be removed and the new lock type to take affect. All locks 
associated with a file for a given process are removed when a file descriptor for that file is 
closed by that process or the process holding that file descriptor terminates. Locks are not 
inherited by a child process in a fork (2) system call. 


RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 


F_DUPFD 

F.GETFD 

F.GETFL 

F.GETLK 

F.GETOWN 

F_SETFD 

FJSETFL 

FJ3ETLK 

FJSETLKW 


A new file descriptor. 

Value of flag (only the low-order bit is defined). 
Value of flags. 

Value other that -1. 

Value of file descriptor owner. 

Value other than -1. 

Value other than -1. 

Value other than -1. 

Value other than -1. 


Otherwise, a value of -1 is returned and errno is set to indicate the error. 


ERRORS 

Fcntl will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EMFILE] Cmd is F_DUPFD and the maximum allowed number of file descriptors are 

currently open. 
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[EINVAL] 

[EINVAL] 

[EACCESS] 

[EMFILE] 

[ENOSPC] 

[EDEADLK] 


Cmd is F_DUPFD and arg is negative or greater the maximum allowable 
number (see getdtablesize(2 )). 

Cmd is F_GETLK, F_SETLK, or SETLKW and arg or the data it points to 
is not valid. 

Cmd is F_SETLK, the type of lock ( L type ) is a read (F_RDLCK) or write 
(F_WRLCK) lock and the segment of a file to be locked is already write 
locked by another process or the type is a write lock and the segment of a 
file to be locked is already read or write locked by another process. 

Cmd is F_SETLK or F_SETLKW, the type of lock is a read or write lock 
and there are no more file locking headers available (too many files have seg¬ 
ments locked). 

Cmd is F_SETLK or FjSETLKW, the type of lock is a read or write lock 
and there are no more file locking headers available (too many files have seg¬ 
ments locked) or there are no more record locks available (too many file seg¬ 
ments locked). 

Cmd is FJSETLK, when the lock is blocked by some lock from another pro¬ 
cess and sleeping (waiting) for that lock to become free, this causes a 
deadlock situation. 


SEE ALSO 

close(2), execve(2), getdtablesize(2), open(2), sigvec(2), fcntl(5) 


BUGS 

The asynchronous I/O facilities of FNDELAY and FASYNC are currently available only for 
tty operations. No SIGIO signal is sent upon draining of output sufficiently for non-blocking 
writes to occur. 
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NAME 

flock - apply or remove an advisory lock on an open file 


SYNOPSIS 

#mclude <sys/file.h> 

^define LOCK_SH 1 

^define LOC K, EX 2 

^define LOCK_NB 4 

^define LOCK.UN 8 

flock(fd, operation) 
int fd, operation; 


/ * shared lock */ 

/* exclusive lock */ 

/* don't block when locking */ 
/ * unlock */ 


DESCRIPTION 

Flock applies or removes an advisory lock on the file associated with the file descriptor fd. A 
lock is applied by specifying an operation parameter which is the inclusive or of LOCK_SH or 
LOCK_EX and, possibly, LOCK_NB. To unlock an existing lock operation should be 
LOCKJJN. 

Advisory locks allow cooperating processes to perform consistent operations on files, but do 
not guarantee consistency (i.e. processes may still access files without using advisory locks pos¬ 
sibly resulting in inconsistencies). 

The locking mechanism allows two types of locks: shared locks and exclusive locks. At any 
time multiple shared locks may be applied to a file, but at no time are multiple exclusive, or 
both shared and exclusive, locks allowed simultaneously on a file. 

A shared lock may be upgraded to an exclusive lock, and vice versa, simply by specifying the 
appropriate lock type; this results in the previous lock being released and the new lock applied 
(possibly after other processes have gained and released the lock). 

Requesting a lock on an object which is already locked normally causes the caller to blocked 
until the lock may be acquired. If LOCK_NB is included in operation, then this will not hap¬ 
pen; instead the call will fail and the error EWOULDBLOCK will be returned. 


NOTES 

Locks are on files, not file descriptors. That is, file descriptors duplicated through dup( 2) or 
fork{ 2) do not result in multiple instances of a lock, but rather multiple references to a single 
lock. If a process holding a lock on a file forks and the child explicitly unlocks the file, the 
parent will lose its lock. 

Processes blocked awaiting a lock may be awakened by signals. 

RETURN VALUE 

Zero is returned if the operation was successful; on an error a -1 is returned and an error code 
is left in the global location errno. 


ERRORS 


The flock call fails if: 


[EWOULDBLOCK] 

The 

[EBADF] 

The 

[EINVAL] 

The 


file is locked and the LOCK_NB option was specified. 

argument fd is an invalid descriptor. 

argument fd refers to an object other than a file. 
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SEE ALSO 

open(2), close(2), dup(2), execve(2), fork(2) 
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NAME 

fork - create a new process 

SYNOPSIS 

pid = fork() 
int pid; 

DESCRIPTION 

Fork causes creation of a new process. The new process (child process) is an exact copy of the 
calling process except for the following: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID of the parent 
process). 

The child process has its own copy of the parent’s descriptors. These descriptors refer¬ 
ence the same underlying objects, so that, for instance, file pointers in file objects are 
shared between the child and the parent, so that a lseek( 2) on a descriptor in the child 
process can affect a subsequent read or write by the parent. This descriptor copying is 
also used by the shell to establish standard input and output for newly created processes 
as well as to set up pipes. 

The child processes resource utilizations are set to 0; see setrlimit( 2). 

RETURN VALUE 

Upon successful completion, fork returns a value of 0 to the child process and returns the pro¬ 
cess ID of the child process to the parent process. Otherwise, a value of -1 is returned to the 
parent process, no child process is created, and the global variable errno is set to indicate the 
error. 

ERRORS 

Fork will fail and no child process will be created if one or more of the following are true: 

[EAGAINJ The system-imposed limit {PROCLMAX} on the total number of processes 

under execution would be exceeded. 

[EAGAIN] The system-imposed limit {KID_MAX} on the total number of processes 

under execution by a single user would be exceeded. 

SEE ALSO 

execve(2), wait(2) 
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NAME 

fsync - synchronize a file’s in-core state with that on disk 

SYNOPSIS 

fsync(fd) 
int fd; 

DESCRIPTION 

Fsync causes all modified data and attributes of fd to be moved to a permanent storage dev¬ 
ice. This normally results in all in-core modified copies of buffers for the associated file to be 
written to a disk. 

Fsync should be used by programs which require a file to be in a known state; for example in 
building a simple transaction facility. 

RETURN VALUE 

A 0 value is returned on success. A -1 value indicates an error. 

ERRORS 

The fsync fails if: 

[EBADF] Fd is not a valid descriptor. 

[EINVAL] Fd refers to a socket, not to a file. 

SEE ALSO 

sync(2), sync(8), update(8) 


BUGS 

The current implementation of this call is expensive for large files. 
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NAME ( > 

getdtablesize - get descriptor table size 

SYNOPSIS 

nds = getdt&blesizeQ 
int nds; 

DESCRIPTION 

Each process has a fixed size descriptor table which is guaranteed to have at least 20 slots. 

The entries in the descriptor table are numbered with small integers starting at 0. The call 
getdtablesize returns the size of this table. 

SEE ALSO 

close(2), dup(2), open(2) 
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NAME 

getgid, getegid - get group identity 

SYNOPSIS 

gid = getgid () 
int gid; 

egid = getegid () 
int egid; 

DESCRIPTION 

Getgid returns the real group ID of the current process, getegid the effective group ID. 

The real group ID is specified at login time. 

The effective group ID is more transient, and determines additional access permission during 
execution of a “set-group-ID” process, and it is for such processes that getgid is most useful. 

SEE ALSO 

getuid(2), setregid(2), setgid(3) 
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NAME 

getgroups - get group access list 

SYNOPSIS 

^include <sys/param.h> 

getgroups(ngroups, gidset) 
int *ngroups, *gidset; 

DESCRIPTION 

Getgroups gets the current group access list of the user process and stores it in the array gid¬ 
set. The parameter ngroups indicates the number of entries which may be placed in gidset 
and is modified on return to indicate the actual number of groups returned. No more than 
NGRPS, as defined in <sys/param.h>, will ever be returned. 

RETURN VALUE 

A value of 0 indicates that the call succeeded, and that the number of elements of gidset and 
the set itself were returned. A value of -1 indicates that an error occurred, and the error code 
is stored in the global variable errno. 

ERRORS 

The possible errors for getgroup are: 

[EFAULT] The arguments ngroups or gidset specify invalid addresses. 

SEE ALSO 

setgroups(2), initgroups(3) 
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NAME 

gethostid, sethostid - get/set unique identifier of current host 

SYNOPSIS 

hostid = gethostidQ 
int hostid; 

sethostid(hostid) 
int hostid; 

DESCRIPTION 

Sethostid establishes a 32-bit identifier for the current processor which is intended to be 
unique among all UNIX systems in existence. This is normally a DARPA Internet address for 
the local machine. This call is allowed only to the super-user and is normally performed at 
boot time. 

Gethostid returns the 32-bit identifier for the current processor. 

SEE ALSO 

hostid(l), gethostname(2) 


BUGS 

32 bits for the identifier is too small. 
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NAME 

gethostname, sethostname - get/set name of current host 

SYNOPSIS 

gethostname(name, namelen) 
char *name; 
int namelen; 

sethostname(name, namelen) 
char *name; 
int namelen; 

DESCRIPTION 

Gethostname returns the standard host name for the current processor, as previously set by 
sethostname. The parameter namelen specifies the size of the name array. The returned name 
is null-terminated unless insufficient space is provided. 

Sethostname sets the name of the host machine to be name , which has length namelen. This 
call is restricted to the super-user and is normally used only when the system is bootstrapped. 

RETURN VALUE 

If the call succeeds a value of 0 is returned. If the call fails, then a value of -1 is returned and 
an error code is placed int the global location errno. 

ERRORS 

The following errors may be returned by these calls: 

[EFAULT] The name or namelen parameter gave an invalid address. 

[EPERM] The caller was not the super-user. 

SEE ALSO 

gethostid(2) 

BUGS 

Host names are limited to 255 characters. 
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NAME 

getitimer, setitimer - get/set value of interval timer 

SYNOPSIS 

include <sys/time.h> 

^define ITIMER_REAL 0 /* real time intervals */ 

^define ITIMERJVTRTUAL 1 /* virtual time intervals */ 

#define ITIMER^PROF 2 /* user and system virtual time */ 

getitimer (which, value) 
int which; 

struct itimerval *value; 

setitimer (which, value, ovalue) 
int which; 

struct itimerval *value, *ovalue; 

DESCRIPTION 

The system provides each process with three interval timers, defined in <sys/time.h>. The 
getitimer call returns the current value for the timer specified in which, while the setitimer call 
sets the value of a timer (optionally returning the previous value of the timer). 

A timer value is defined by the itimerval structure: 
struct itimerval { 

struct timeval it_interval; /* timer interval */ 
struct timeval it_value; /* current value */ 

}> 

If it_value is non-zero, it indicates the time to the next timer expiration. If it_interval is non¬ 
zero, it specifies a value to be used in reloading it_value when the timer expires. Setting 
it_value to 0 disables a timer. Setting it_interval to 0 causes a timer to be disabled after its 
next expiration (assuming it_value is non-zero). 

Time values smaller than the resolution of the system clock are rounded up to this resolution. 

The ITIMER_REAL timer decrements in real time. A SIGALRM signal is delivered when this 
timer expires. 

The ITIMER_VIRTUAL timer decrements in process virtual time. It runs only when the pro¬ 
cess is executing. A SIGVTALRM signal is delivered when it expires. 

The ITIMER_PROF timer decrements both in process virtual time and when the system is 
running on behalf of the process. It is designed to be used by interpreters in statistically 
profiling the execution of interpreted programs. Each time the ITIMER_PROF timer expires, 
the SIGPROF signal is delivered. Because this signal may interrupt in-progress system calls, 
programs using this timer must be prepared to restart interrupted system calls. 


NOTES 

Three macros for manipulating time values are defined in <sys/time.h >. Timerclear sets a 
time value to zero, timerisset tests if a time value is non-zero, and timercmp compares two 
time values (beware that >= and <= do not work with this macro). 
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RETURN VALUE 

If the calls succeed, a value of 0 is returned. If an error occurs, the value -1 is returned, and a 
more precise error code is placed in the global variable errno. 

ERRORS 

The possible errors are: 

[EFAULT] The value structure specified a bad address. 

[EINVAL] A value structure specified a time was too large to be handled. 

SEE ALSO 

sigvec(2), gettimeofday(2) 
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NAME 

getpagesize - get system page size 

SYNOPSIS 

pagesize = getpagesize() 
int pagesize; 


granularity of 
hardware page 


SEE ALSO 

sbrk(2), pagesize(l) 


DESCRIPTION 

Getpagesize returns the number of bytes in a page. Page granularity is the 
many of the memory management calls. 

The page size is a system page size and may not be the same as the underlying 
size. 
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NAME 

getpeername - get name of connected peer 

SYNOPSIS 

getpeername(s, name, namelen) 
int b; 

struct sockaddr *name; 
int *namelen; 

DESCRIPTION 

Getpeername returns the name of the peer connected to socket s. The namelen parameter 
should be initialized to indicate the amount of space pointed to by name. On return it con¬ 
tains the actual size of the name returned (in bytes). 

DIAGNOSTICS 

A 0 is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument s is a file, not a socket. 

[ENOTCONN] The socket is not connected. 

[ENOBUFS] Insufficient resources were available in the system to perform the operation. 

[EFAULT] The name parameter points to memory not in a valid part of the process 

address space. 

SEE ALSO 

bind(2), socket(2), getsockname(2) 

BUGS 

Names bound to sockets in the UNIX domain are inaccessible; getpeername returns a zero 
length name. 
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NAME 

getpgrp - get process group 

SYNOPSIS 

Pgrp = getpgrp(pid) 
int prgp; 
int pid; 

DESCRIPTION 

The process group of the specified process is returned by getpgrp. If pid is zero, then the call 
applies to the current process. 

Process groups are used for distribution of signals, and by terminals to arbitrate requests for 
their input: processes which have the same process group as the terminal are foreground and 
may read, while others will block with a signal if they attempt to read. 

This call is thus used by programs such as cslr( 1) to create process groups in implementing job 
control. The TIOCGPGRP and TIOCSPGRP calls described in tty{ 4) are used to get/set the 
process group of the control terminal. 

SEE ALSO 

setpgrp(2), getuid(2), tty(4) 
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NAME 

getpid, getppid - get process identification 

SYNOPSIS 

pid — getpidQ 
long pid; 

ppid = getppid () 
long ppid; 

DESCRIPTION 

Getpid returns the process ID of the current process. Most often it is used with the host 
identifier gethostid(2 ) to generate uniquely-named temporary files. 

Getppid returns the process ID of the parent of the current process. 

SEE ALSO 

gethostid(2) 
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NAME 

getpriority, setpriority - get/set program scheduling priority 

SYNOPSIS 

^include <sys/resource.h> 

^define PRIO^PROCESS 0 
^define PRIO_PGRP 
^define PRIO_USER 

prio = getpriority(which, who) 
int prio, which, who; 

setpriority (which, who, prio) 
int which, who, prio; 

DESCRIPTION 

The scheduling priority of the process, process group, or user, as indicated by which and who 
is obtained with the getpriority call and set with the setpriority call. Which is one of 
PRIOJPROCESS, PRIO_PGRP, or PRIO_USER, and who is interpreted relative to which (a 
process identifier for PRIOJPROCESS, process group identifier for PRIO_PGRP, and a user 
ID for PR10_USER). Prio is a value in the range -20 to 20. The default priority is 0; lower 
priorities cause more favorable scheduling. 

The getpriority call returns the highest priority (lowest numerical value) enjoyed by any of the 
specified processes. The setpriority call sets the priorities of all of the specified processes to the 
specified value. Only the super-user may lower priorities. 

RETURN VALUE 

Since getpriority can legitimately return the value -1, it is necessary to clear the external vari¬ 
able errno prior to the call, then check it afterward to determine if a -1 is an error or a legiti¬ 
mate value. The setpriority call returns 0 if there is no error, or -1 if there is. 

ERRORS 

Getpriority and setpriority may return one of the following errors: 

[ESRCH] No process(es) were located using the which and who values specified. 

[EINVAL] Which was not one of PRIO_PROCESS, PRIO_PGRP, or PRIOJJSER. 

In addition to the errors indicated above, setpriority may fail with one of the following errors 
returned: 

[EACCES] A process was located, but neither its effective nor real user ID matched the 
effective user ID of the caller. 

[EACCES] A non super-user attempted to change a process priority to a negative value. 


/* process */ 

1 /* process group */ 

2 /* user id */ 


SEE ALSO 

nice(l), fork(2), renice(8) 
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NAME 

getrlimit, setrlimit - control maximum system resource consumption 

SYNOPSIS 

^include <sys/time.h> 

^include <sys/resource.h> 

getrlimit(resource, rip) 
int resource; 
struct rlimit *rlp; 

setriimit(resource, rip) 
int resource; 
struct rlimit *rlp; 

DESCRIPTION 

Limits on the consumption of system resources by the current process and each process it 
creates may be obtained with the getrlimit call, and set with the setrlimit call. 

The resource parameter is one of the following: 

RLIMIT_CPU the maximum amount of cpu time (in milliseconds) to be used by each 
process. 

RLIMIT_FSIZE the largest size, in bytes, of any single file which may be created. 

RLIMIT_DATA the maximum size, in bytes, of the data segment for a process; this defines 
how far a program may extend its break with the sbrk( 2) system call. 

RLIMITJ3TACK the maximum size, in bytes, of the stack segment for a process; this defines 
how far a program’s stack segment may be extended, either automatically 
by the system, or explicitly by a user with the sbrk(2 ) system call. 

RLIMIT_CORE the largest size, in bytes, of a core file which may be created. 

RLIMIT_RSS the maximum size, in bytes, a process’s resident set size may grow to. 

This imposes a limit on the amount of physical memory to be given to a 
process; if memory is tight, the system will prefer to take memory from 
processes which are exceeding their declared resident set size. 

A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a 
process may receive a signal (for example, if the cpu time is exceeded), but it will be allowed 
to continue execution until it reaches the hard limit (or modifies its resource limit). The rlimit 
structure is used to specify the hard and soft limits on a resource, 

struct rlimit { 

int rlim_cur; /* current (soft) limit */ 

int rlim_max; /* hard limit */ 

}; 

Only the super-user may raise the maximum limits. Other users may only alter rlim_cur 
within the range from 0 to rlim_max or (irreversibly) lower rlim_max. 

An “infinite” value for a limit is defined as RLIMIT_INFINITY (0x7fffffff). 

Because this information is stored in the per-process information, this system call must be exe¬ 
cuted directly by the shell if it is to affect all future processes created by the shell; limit is 
thus a built-in command to cs^(l). 
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The system refuses to extend the data or stack space when the limits would be exceeded in 
the normal way: a break call fails if the data space limit is reached, or the process is killed 
when the stack limit is reached (since the stack cannot be extended, there is no way to send a 
signal!). 

A file i/o operation which would create a file which is too large will cause a signal SIGXFSZ to 
be generated, this normally terminates the process, but may be caught. When the soft cpu 
time limit is exceeded, a signal SIGXCPU is sent to the offending process. 

RETURN VALUE 

A 0 return value indicates that the call succeeded, changing or returning the resource limit. 
A return value of -1 indicates that an error occurred, and an error code is stored in the global 
location errno. 

ERRORS 

The possible errors are: 

[EFAULT] The address specified for rip is invalid. 

[EPERM] The limit specified to setrlimit would have 

raised the maximum limit value, and the caller is not the super-user. 

SEE ALSO 

csh(l), quota(2) 

BUGS 

There should be limit and unlimit commands in s/i(l) as well as in csh. 
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NAME 

getrusage - get information about resource utilization 

SYNOPSIS 

^include <sys/time.h> 

^include <sys/resource.h> 

^define RUSAGE_SELF 0 

/* calling process */ 

#define RUSAGE_CHILDREN -1 

/* terminated child processes */ 

getrusage(who, rusage) 
int who; 

struct rusage *rusage; 


DESCRIPTION 

Getrusage returns information describing the resources utilized by the current process, or all 
its terminated child processes. The who parameter is one of RUSAGE_SELF and 
RUSAGE_CHILDREN. If rusage is non-zero, the buffer it points to will be filled in with the 
following structure: 


struct 


}; 


rusage { 

struct timeval ru_utime; 
struct timeval ru_stime; 


int 

ru_maxrss; 

int 

ru_ixrss; 

int 

rujidrss; 

int 

ru_isrss; 

int 

ru_minflt; 

int 

ru_majflt; 

int 

ru_nswap; 

int 

ru_inblock; 

int 

ru_ou block; 

int 

ru_msgsnd; 

int 

ru_msgrcv; 

int 

ru_nsignals; 

int 

ru_nvcsw; 

int 

ru_nivcsw; 


/* user time used */ 

/* system time used */ 

/* integral shared memory size */ 
/* integral unshared data size */ 
/* integral unshared stack size */ 
/* page reclaims */ 

/* page faults */ 

/* swaps */ 

/* block input operations */ 

/* block output operations */ 

/* messages sent */ 

/* messages received */ 

/* signals received */ 

/* voluntary context switches */ 
/* involuntary context switches */ 


The fields are interpreted as follows: 


ru_utime 


the total amount of time spent executing in user mode. 


ru_stime 

ru_maxrss 

ru_ixrss 


ru_idrss 


the total amount of time spent in the system executing on behalf of the 
process(es). 

the maximum resident set size utilized (in kilobytes). 

an “integral” value indicating the amount of memory used which was also 
shared among other processes. This value is expressed in units of kilobytes * 
seconds-of-execution and is calculated by summing the number of shared 
memory pages in use each time the internal system clock ticks and then 
averaging over 1 second intervals. 

an integral value of the amount of unshared memory residing in the data 
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GETRUSAGE (2) 


GETRUSAGE (2) 


SYSTEM CALLS 


ru_isrss 

ru_minflt 


ru_majflt 

ru_nswap 

ru_inblock 

ru_outblock 

ru_msgsnd 

ru_msgrcv 

ru_nsignals 

ru_nvcsw 


ru_nivcsw 


segment of a process (expressed in units of kilobytes * seconds-of-execution). 

an integral value of the amount of unshared memory residing in the stack 
segment of a process (expressed in units of kilobytes * seconds-of-execution). 

the number of page faults serviced without any i/o activity; here i/o activity 
is avoided by “reclaiming” a page frame from the list of pages awaiting real- 
location. 

the number of page faults serviced which required i/o activity. 

the number of times a process was “swapped” out of main memory. 

the number of times the file system had to perform input. 

the number of times the file system had to perform output. 

the number of ipc messages sent. 

the number of ipc messages received. 

the number of signals delivered. 

the number of times a context switch resulted due to a process voluntarily 
giving up the processor before its time slice was completed (usually to await 
availability of a resource). 

the number of times a context switch resulted due to a higher priority pro¬ 
cess becoming runnable or because the current process exceeded its time slice. 


NOTES 

The numbers ru_inblock and ru_outblock account only for real i/o; data supplied by the cache- 
ing mechanism is charged only to the first process to read or write the data. 


SEE ALSO 

gettimeofday(2), wait(2) 


BUGS 

There is no way to obtain information about a child process which has not yet terminated. 
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GETSOCKNAME (2) 


SYSTEM CALLS 


GETSOCKNAME (2) 


NAME 

getsockname - get socket name 

SYNOPSIS 

getsockname(s, name, namelen) 
int s; 

struct sockaddr *name; 
int *namelen; 

DESCRIPTION 

Getsockname returns the current name for the specified socket. The namelen parameter 
should be initialized to indicate the amount of space pointed to by name. On return it con¬ 
tains the actual size of the name returned (in bytes). 

DIAGNOSTICS 

A 0 is returned if the call succeeds, -1 if it fails. 


ERRORS 

The call succeeds unless: 


[EBADF] 

[ENOTSOCK] 

[ENOBUFS] 

[EFAULT] 


The argument s is not a valid descriptor. 

The argument s is a file, not a socket. 

Insufficient resources were available in the system to perform the operation. 

The name parameter points to memory not in a valid part of the process 
address space. 


SEE ALSO 

bind(2), socket(2) 


BUGS 

Names bound to sockets in the UNIX domain are inaccessible; getsockname returns a zero 
length name. 
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GETSOCKOPT (2) 


SYSTEM CALLS 


GETSOCKOPT (2) 


NAME 

getsockopt, setsockopt - get and set options on sockets 

SYNOPSIS 

^include <sys/types.h> 

#inelude <sys/socket.h> 

getsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 
char *optval; 
int *optlen; 

setsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 
char *optval; 
int optlen; 


DESCRIPTION 

Getsockopt and setsockopt manipulate options associated with a socket. Options may exist at 
multiple protocol levels; they are always present at the uppermost “socket” level. 

When manipulating socket options the level at which the option resides and the name of the 
option must be specified. To manipulate options at the “socket” level, level is specified as 
SOL_SOCI<ET. To manipulate options at any other level the protocol number of the 
appropriate protocol controlling the option is supplied. For example, to indicate an option is 
to be interpreted by the TCP protocol, level should be set to the protocol number of TCP; see 
getprotoent( 3N). 

The parameters optval and optlen are used to access option values for setsockopt. For get¬ 
sockopt they identify a buffer in which the value for the requested option(s) are to be returned. 
For getsockopt, optlen is a value-result parameter, initially containing the size of the buffer 
pointed to by optval, and modified on return to indicate the actual size of the value returned. 
If no option value is to be supplied or returned, optval may be supplied as 0. 

Optname and any specified options are passed uninterpreted to the appropriate protocol 
module for interpretation. The include file <sys/socket.h> contains definitions for “socket” 
level options; see socket{ 2). Options at other protocol levels vary in format and name, consult 
the appropriate entries in (4P). 


RETURN VALUE 

A 0 is returned if the call succeeds, -1 if it fails. 


ERRORS 

The call succeeds unless: 
[EBADF] The 

[ENOTSOCK] The 

[ENOPROTOOPT] The 
[EFAULT] The 

SEE ALSO 


argument s is not a valid descriptor, 
argument s is a file, not a socket, 
option is unknown. 

options are not in a valid part of the process address space. 


socket(2), getprotoent(3N) 
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GETTIMEOFDAY (2) 


SYSTEM CALLS 


GETTIMEOFDAY (2) 


NAME 

gettimeofday, settimeofday - get/set date and time 

SYNOPSIS 

^include <sys/time.h> 

gettimeofday(tp, tzp) 
struct timeval *tp; 
struct timezone *tzp; 

settimeofday(tp, tzp) 
struct timeval *tp; 
struct timezone *tzp; 

DESCRIPTION 

Gettimeofday returns the system’s notion of the current Greenwich time and the current time 
zone. Time returned is expressed relative in seconds and microseconds since midnight January 
1, 1970. 

The structures pointed to by tp and tzp are defined in <sys/time.li> as: 

struct timeval { 

u_long tv_sec; 

/* seconds since Jan. 1, 1970 */ 
long tv_usec; 

/* and microseconds */ 

}> 

struct timezone { 

int tz_minuteswest; 

/* of Greenwich */ 
int tz_dsttime; 

/* type of dst correction to apply */ 

}; 

The timezone structure indicates the local time zone (measured in minutes of time westward 
from Greenwich), and a flag that, if nonzero, indicates that Daylight Saving time applies 
locally during the appropriate part of the year. 

Only the super-user may set the time of day. 

RETURN 

A 0 return value indicates that the call succeeded. A -1 return value indicates an error 
occurred, and in this case an error code is stored into the global variable errno. 

ERRORS 

The following error codes may be set in errno: 

[EFAULT] An argument address referenced invalid memory. 

[EPERM] A user other than the super-user attempted to set the time. 

SEE ALSO 

date(l), ctime(3) 


ICON INTERNATIONAL 


1 



GETTIMEOFDAY (2) 


SYSTEM CALLS 


GETTIMEOFDAY (2) 


BUGS 

Time is never correct enough to believe the microsecond values. There should a mechanism 
by which, at least, local clusters of systems might synchronize their clocks to millisecond 
granularity. 
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GETUID (2) 


SYSTEM CALLS 


GETUID (2) 


NAME 

getuid, geteuid - get user identity 

SYNOPSIS 

uid ass getuid() 
int uid; 

euid = geteuid() 
int euid; 



DESCRIPTION 

Getuid returns the real user ID of the current process, geteuid the effective user ID. 

The real user ID identifies the person who is logged in. The effective user ID gives the process 
additional permissions during execution of “set-user-ID” mode processes, which use getuid to 
determine the real-user-id of the process which invoked them. 


SEE ALSO 

getgid(2), setreuid(2) 
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IOCTL (2) 


SYSTEM CALLS 


IOCTL(2) 


NAME 

ioctl - control device 

SYNOPSIS 

^include <sys/ioctl.h> 

ioctl(d, request, argp) 
int d, request; 
char *argp; 

DESCRIPTION 

Ioctl performs a variety of functions on open descriptors. In particular, many operating 
characteristics of character special files (e.g. terminals) may be controlled with ioctl requests. 
The writeups of various devices in section 4 discuss how ioctl applies to them. 

An ioctl request has encoded in it whether the argument is an “in” parameter or “out” 
parameter, and the size of the argument argp in bytes. Macros and defines used in specifying 
an ioctl request are located in the file <sys/ioctl.h>. 

RETURN VALUE 

If an error has occurred, a value of -1 is returned and errno is set to indicate the error. 

ERRORS 

Ioctl will fail 

[EBADF] 

[ENOTTY] 

[ENOTTY] 

[EINVAL] 

SEE ALSO 

execve(2), fcntl(2), mt(4), tty(4), intro(4N) 


if one or more of the following are true: 

D is not a valid descriptor. 

D is not associated with a character special device. 

The specified request does not apply to the kind of object which the descrip¬ 
tor d references. 

Request or argp is not valid. 
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KILL(2) 


SYSTEM CALLS 


KILL (2) 


NAME r 

kill - send signal to a process v 

SYNOPSIS 

kill(pid, sig) 
int pid, sig; 

DESCRIPTION 

Kill sends the signal sig to a process, specified by the process number pid. Sig may be one of 
the signals specified in sigvec( 2), or it may be 0, in which case error checking is performed but 
no signal is actually sent. This can be used to check the validity of pid. 

The sending and receiving processes must have the same effective user ID, otherwise this call is 
restricted to the super-user. A single exception is the signal SIGCONT which may always be 
sent to any child or grandchild of the current process. 

If the process number is 0, the signal is sent to all other processes in the sender’s process 
group; this is a variant of killpg(2). 

If the process number is -1, and the user is the super-user, the signal is broadcast universally 
except to system processes and the process sending the signal. 

Processes may send signals to themselves. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Kill will fail and no signal will be sent if any of the following occur: 

[EINYAL] Sig is not a valid signal number. 

[ESRCH] No process can be found corresponding to that specified by pid. 

[EPERM] The sending process is not the super-user and its effective user id does not 

match the effective user-id of the receiving process. 

SEE ALSO 

getpid(2), getpgrp(2), killpg(2), sigvec(2) 


ICON INTERNATIONAL 


1 




KILLPG (2) 


SYSTEM CALLS 


KILLPG (2) 


NAME 

killpg - send signal to a process group 

SYNOPSIS 

killpg(pgrp, sig) 
int pgrp, sig; 

DESCRIPTION 

Killpg sends the signal sig to the process group pgrp. See sigvec(2) for a list of signals. 

The sending process and members of the process group must have the same effective user ID, 
otherwise this call is restricted to the super-user. As a single special case the continue signal 
SIGCONT may be sent to any process which is a descendant of the current process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
the global variable errno is set to indicate the error. 

ERRORS 

Killpg will fail and no signal will be sent if any of the following occur: 

[EINVAL] Sig is not a valid signal number. 

[ESRCH] No process can be found corresponding to that specified by pid. 

[EPERM] The sending process is not the super-user and one or more of the target 

processes has an effective user ID different from that of the sending process. 

SEE ALSO 

kill(2), getpgrp(2), sigvec(2) 
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LINK (2) 


SYSTEM CALLS 


LINK (2) 


NAME 

link - make a hard link to a file 

SYNOPSIS 

link(namel, name2) 
char *namel, *name2; 

DESCRIPTION 

A hard link to namel is created; the link has the name name2. Namel must exist. 

With hard links, both namel and name2 must be in the same file system. Unless the caller is 
the super-user, namel must not be a directory. Both the old and the new link share equal 
access and rights to the underlying object. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Link will fail 

[EPERM] 

[ENOENT] 

[ENOTDIR] 

(ENOENT] 

[EACCES] 

[ENOENT] 

[EEXIST] 

(EPERM] 

[EXDEV] 

[EACCES] 

[EROFS] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

symlink(2), unlink(2) 


and no link will be created if one or more of the following are true: 

Either pathname contains a byte with the high-order bit set. 

Either pathname was too long. 

A component of either path prefix is not a directory. 

A component of either path prefix does not exist. 

A component of either path prefix denies search permission. 

The file named by namel does not exist. 

The link named by nameS does exist. 

The file named by namel is a directory and the effective user ID is not 
super-user. 

The link named by nameS and the file named by namel are on different file 
systems. 

The requested link requires writing in a directory w’ith a mode that denies 
write permission. 

The requested link requires writing in a directory on a read-only file system. 

One of the pathnames specified is outside the process’s allocated address 
space. 

Too many symbolic links were encountered in translating the pathname. 
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LISTEN (2) 


SYSTEM CALLS 


LISTEN (2) 


NAME 

listen - listen for connections on a socket 

SYNOPSIS 

listen(s, backlog) 
int s, backlog; 

DESCRIPTION 

To accept connections, a socket is first created with socket( 2), a backlog for incoming connec¬ 
tions is specified with listen(2 ) and then the connections are accepted with accept( 2). The 
listen call applies only to sockets of type SOCK_STREAM or SOCKLpKTSTREAM. 

The backlog parameter defines the maximum length the queue of pending connections may 
grow to. If a connection request arrives with the queue full the client will receive an error 
with an indication of ECONNREFUSED. 

RETURN VALUE 

A 0 return value indicates success; -1 indicates an error. 

ERRORS 

The call fails if: 

[EBADF] 

[ENOTSOCK] 

[EOPNOTSUPP] 

SEE ALSO 

accept(2), connect(2), socket(2) 


The argument s is not a valid descriptor. 

The argument s is not a socket. 

The socket is not of a type that supports the operation listen. 


BUGS 

The backlog is currently limited (silently) to 5. 


ICON INTERNATIONAL 


1 



LSEEK (2) 


SYSTEM CALLS 


LSEEK (2) 


NAME 

Iseek - move read/write pointer 

SYNOPSIS 

#define LJSET 0 /* set the seek pointer */ 

#define LJNCRl /* increment the seek pointer */ 

^define L_XTND 2/* extend the file size */ 

pos = Iseek(d, offset, whence) 
int pos; 

int d, offset, whence; 

DESCRIPTION 

The descriptor d refers to a file or device open for reading and/or writing. Lseek sets the file 
pointer of d as follows: 

If whence is L-SET, the pointer is set to offset bytes. 

If whence is L_INCR, the pointer is set to its current location plus offset. 

If whence is L_XTND, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes from begin¬ 
ning of the file is returned. Some devices are incapable of seeking. The value of the pointer 
associated with such a device is undefined. 

NOTES 

Seeking far beyond the end of a file, then writing, creates a gap or “hole”, which occupies no 
physical space and reads as zeros. 

RETURN VALUE 

Upon successful completion, a non-negative integer, the current file pointer value, is returned. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 

ERRORS 

Lseek will fail and the file pointer will remain unchanged if: 

[EBADF] Fildes is not an open file descriptor. 

[ESPIPE] Fildes is associated with a pipe or a socket. 

[EINVAL] Whence is not a proper value. 

[EINVAL] The resulting file pointer would be negative. 

SEE ALSO 

dup(2), open(2) 


bugs 

This document’s use of whence is incorrect English, but maintained for historical reasons. 


V. 
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MKDIR (2) 


SYSTEM CALLS 


MKDIR (2) 


NAME 

mkdir - make a directory file 

SYNOPSIS 

mkdir(path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Mkdir creates a new directory file with name path. The mode of the new file is initialized from 
mode. (The protection part of the mode is modified by the process’s mode mask; see 
umask( 2)). 

The directory’s owner ID is set to the process’s effective user ID. The directory’s group ID is 
set to that of the parent directory in which it is created. 

The low-order 9 bits of mode are modified by the process’s file mode creation mask: all bits 
set in the process’s file mode creation mask are cleared. See umask( 2). 

RETURN VALUE 

A 0 return value indicates success. A -1 return value indicates an error, and an error code is 
stored in errno. 

ERRORS 

Mkdir will fail 

[EPERM] 

[EPERM] 

[ENOTDIR] 

[ENOENT] 

[EROFS] 

[EEXIST] 

[EFAULT] 

[ELOOP] 

[EIO] 

SEE ALSO 

chmod(2), stat(2), umask(2) 


and no directory will be created if: 

The process’s effective user ID is not super-user. 

The path argument contains a byte with the high-order bit set. 

A component of the path prefix is not a directory. 

A component of the path prefix does not exist. 

The named file resides on a read-only file system. 

The named file exists. 

Path points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
An I/O error occured while writing to the file system. 
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MKNOD (2) 


SYSTEM CALLS 


MKNOD (2) 


NAME 

mknod - make a special file 

SYNOPSIS 

mknod(path, mode, dev) 
char *p&th; 
int mode, dev; 

DESCRIPTION 

Mknod creates a new file whose name is path. The mode of the new file (including special file 
bits) is initialized from mode. (The protection part of the mode is modified by the process’s 
mode mask; see umask[ 2)). The first block pointer of the i-node is initialized from dev and is 
used to specify which device the special file refers to. 

If mode indicates a block or character special file, dev is a configuration dependent 
specification of a character or block I/O device. If mode does not indicate a block special or 
character special device, dev is ignored. 

Mknod may be invoked only by the super-user. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Mknod will fail 

[EPERM] 

[EPERM] 

[ENOTDIR] 

(ENOENT] 

[EROFS] 

[EEXIST] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

chmod(2), stat(2), umask(2) 


and the file mode will be unchanged if: 

The process’s effective user ID is not super-user. 

The pathname contains a character with the high-order bit set. 

A component of the path prefix is not a directory. 

A component of the path prefix does not exist. 

The named file resides on a read-only file system. 

The named file exists. 

Path points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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MOUNT(2) 


SYSTEM CALLS 


MOUNT(2) 


NAME 

mount, umount - mount or remove file system 

SYNOPSIS 

mount(special, name, rwflag) 
char ^special, *name; 
int rwflag; 

umount(special) 
char ^special; 


DESCRIPTION 

Mount announces to the system that a removable file system has been mounted on the block- 
structured special file special; from now on, references to file name will refer to the root file on 
the newly mounted file system. Special and name are pointers to null-terminated strings con¬ 
taining the appropriate path names. 

Name must exist already. Name must be a directory. Its old contents are inaccessible while 
the file system is mounted. 

The rwflag argument determines whether the file system can be written on; if it is 0 writing is 
allowed, if non-zero no writing is done. Physically write-protected and magnetic tape file sys¬ 
tems must be mounted read-only or errors will occur when access times are updated, whether 
or not any explicit write is attempted. 

Umount announces to the system that the special file is no longer to contain a removable file 
system. The associated file reverts to its ordinary interpretation. 


RETURN VALUE 

Mount returns 0 if the action occurred, -1 if special is inaccessible or not an appropriate file, if 
name does not exist, if special is already mounted, if name is in use, or if there are already too 
many file systems mounted. 

Umount returns 0 if the action occurred; -1 if if the special file is inaccessible or does not have 
a mounted file system, or if there are active files in the mounted file system. 


ERRORS 

Mount will fail 

[NODEV] 

[NODEV] 

[ENOTBLK] 

[ENXIO] 

[EPERM] 

[ENOTDIR] 

[EROFS] 

[EBUSY] 

[EBUSY] 

[EBUSY] 


when one of the following occurs: 

The caller is not the super-user. 

Special does not exist. 

Special is not a block device. 

The major device number of special is out of range (this indicates no device 
driver exists for the associated hardware). 

The pathname contains a character with the high-order bit set. 

A component of the path prefix in name is not a directory. 

Name resides on a read-only file system. 

Name is not a directory, or another process currently holds a reference to it. 
No space remains in the mount table. 

The super block for the file system had a bad magic number or an out of 
range block size. 
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SYSTEM CALLS 


MOUNT(2) 


[EBUSY] 

[EBUSY] 


Umount may 

[NODEV] 

[NODEV] 

[ENOTBLK] 

[ENXIO] 

[EINVAL] 

[EBUSY] 


Not enough memory was available to read the cylinder group information for 
the file system. 

An i/o error occurred while reading the super block or cylinder group infor¬ 
mation. 

fail with one of the following errors: 

The caller is not the super-user. 

Special does not exist. 

Special is not a block device. 

The major device number of special is out of range (this indicates no device 
driver exists for the associated hardware). 

The requested device is not in the mount table. 

A process is holding a reference to a file located on the file system. 


SEE ALSO 

mount(8), umount(8) 


BUGS 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 


2 


ICON INTERNATIONAL 


MSGCTL(2) 


SYSTEM CALLS 


MSGCTL(2) 


NAME 

msgctl - message control operations 

SYNOPSIS 

^include <sys/types.h> 
^include <sys/ipc.h> 

^include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 
struct msqid_ds *buf; 


DESCRIPTION 

Msgctl provides a variety of message control operations as specified by cmd. The following 
cmds are available: 


IPC_STAT 

IPCLSET 


IPC_RMID 


Place the current value of each member of the data structure associated with 
msqid into the structure pointed to by buf. The contents of this structure 
are defined in intro{ 2). {READ} 

Set the value of the following members of the data structure associated with 
msqid to the corresponding value found in the structure pointed to by buf: 
msg_perm.uid 
msg_perm.gid 

msg_perm.mode /* only low 9 bits */ 
msg_qbytes 

This cmd can only be executed by a process that has an effective user ID 
equal to either that of super user or to the value of msg_perm.uid in the 
data structure associated with msqid. Only super user can raise the value of 

msg_qbytes. 

Remove the message queue identifier specified by msqid from the system and 
destroy the message queue and data structure associated with it. This cmd 
can only be executed by a process that has an effective user ID equal to either 
that of super user or to the value of msg_perm.uid in the data structure 
associated with msqid. 


Msgctl will fail if one or more of the following are true: 


[EINVAL] 

[EINVAL] 

[EACCES] 

[EPERM] 


[EPERM] 

[EFAULT] 


Msqid is not a valid message queue identifier. 

Cmd is not a valid command. 

Cmd is equal to IPCLSTAT and {READ} operation permission is denied to the 
calling process (see intro(2)). 

Cmd is equal to IPCLRMID or IPCLSET The effective user ID of the calling 
process is not equal to that of super user and it is not equal to the value of 
msg_perm.uid in the data structure associated with msqid. 

Cmd is equal to IPC_SET, an attempt is being made to increase to the value 
of msg_qbytes, and the effective user ID of the calling process is not equal to 
that of super user. 

Buf points to an illegal address. 
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SYSTEM CALLS 


MSGCTL(2) 


RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 

intro(2), msgget(2), msgop(2). 
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MSGGET(2) 


SYSTEM CALLS 


MSGGET(2) 


NAME 

msgget - get message queue 

SYNOPSIS 

^include <sys/types.h> 
#include <sys/ipc.h> 
include <sys/msg.h> 

int msgget (key, msgflg) 
key_t key; 
int msgflg; 


DESCRIPTION 

Msgget returns the message queue identifier associated with key. 

A message queue identifier and associated message queue and data structure (see tnfro(2)) are 
created for key if one of the following are true: 

10 Key is equal to IPCLPRIVATE 

Key does not already have a message queue identifier associated with it, and ( msgflg & 
IPCLCREAT) is “true”. 

Upon creation, the data structure associated with the new message queue identifier is initial¬ 
ized as follows: 


Msg_perm.cmd, msg_perm.uid, msg_perm.cgid, and msg_perm.gid are set 

equal to the effective user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of msg_perm.mode are set equal to the low-order 9 bits of 
msgflg. 

Msg_qnum, msg_lspid, msg_lrpid, msg_stime, and msg_rtime are set equal to 0. 
Msg_ctime is set equal to the current time. 

Msg_qbytes is set equal to the system limit. 

Msgget will fail if one or more of the following are true: 

[EACCES] A message queue identifier exists for key, but operation permission (see 

intro{2)) as specified by the low-order 9 bits of msgflg would not be granted. 

[ENOENT] A message queue identifier does not exist for key and ( msgflg & IPCLCREAT) 

is “false”. 


[ENOSPC] A message queue identifier is to be created but the system-imposed limit on 

the maximum number of allowed message queue identifiers system wide 
would be exceeded. 

[EEXIST] A message queue identifier exists for key but ( ( msgflg & IPCLCREAT) & ( 

msgflg & IPCJEXCL) ) is “true”. 


RETURN VALUE 

Upon successful completion, a non-negative integer, namely a message queue identifier, is 
returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 

intro(2), msgctl(2), msgop(2). 
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NAME 

msgop - message operations 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/ipc.h> 
include <sys/msg.h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz, msgflg; 

int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 

Msgsnd is used to send a message to the queue associated with the message queue identifier 
specified by msqid. {WRITE} Msgp points to a structure containing the message. This struc¬ 
ture is composed of the following members: 

long mtype; /* message type */ 

char mtext[j; /* message text */ 

Mtype is a positive integer that can be used by the receiving process for message selection (see 
msgrcv belowj. Mtexl is any text of length msgsz bytes. Msgsz can range from 0 to a system- 
imposed maximum. 

Msgflg specifies the action to be taken if one or more of the following are true: 

The number of bytes already on the queue is equal to msg_qbytes (see intro( 2)). 

The total number of messages on all queues system-wide is equal to the system- 
imposed limit. 

These actions are as follows: 

If ( msgflg & IPCJNOWAIT) is “true”, the message will not be sent and the calling pro¬ 
cess will return immediately. 

If ( msgflg & IPC_NOWAIT) is “false”, the calling process will suspend execution until 
one of the following occurs: 

The condition responsible for the suspension no longer exists, in which case 
the message is sent. 

Msqid is removed from the system (see msgctl( 2)). When this occurs, errno is 
set equal toEIDRM, and a value of -1 is returned. 

The calling process receives a signal that is to be caught. In this case the 
message is not sent and the calling process resumes execution in the manner 
prescribed in signal(2)). 

Msgsnd will fail and no message will be sent if one or more of the following are true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process (see intro(2)). 
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[EINVAL] Mtype is less than 1. 

(EAGAIN] The message cannot be sent for one of the reasons cited above and ( msgflg & 

IPCLNOWAIT) is “true”. 

[EINVAL] Msgsz is less than zero or greater than the system-imposed limit. 

[EFAULT] Msgp points to an illegal address. 

Upon successful completion, the following actions are taken with respect to the data structure 
associated with msqtd (see intro (2)). 

Msg_qnum is incremented by 1. 

Msg_lspid is set equal to the process ID of the calling process. 

Msg_stime is set equal to the current time. 

Msgrcv reads a message from the queue associated with the message queue identifier specified 
by msqtd and places it in the structure pointed to by msgp. {READ} This structure is com¬ 
posed of the following members: 

long mtype; /* message type */ 

char mtext[]; /* message text */ 

Mtype is the received message’s type as specified by the sending process. Mtext is the text of 
the message. Msgsz specifies the size in bytes of mtext. The received message is truncated to 
msgsz bytes if it is larger than msgsz and (msgflg & MSG_NOERROR) is “true”. The trun¬ 
cated part of the message is lost and no indication of the truncation is given to the calling 
process. 

Msgtyp specifies the type of message requested as follows: 

If msgtyp is equal to 0, the first message on the queue is received. 

If msgtyp is greater than 0, the first message of type msgtyp is received. 

If msgtyp is less than 0, the first message of the lowest type that is less than or equal 
to the absolute value of msgtyp is received. 

Msgflg specifies the action to be taken if a message of the desired type is not on the queue. 
These are as follows: 

If (msgflg & IPCLNOWAIT) is “true”, the calling process will return immediately with 
a return value of -1 and errno set toENOMSG. 

If (msgflg & IPC_NOWAIT) is “false”, the calling process will suspend execution until 
one of the following occurs: 

A message of the desired type is placed on the queue. 

Msqtd is removed from the system. When this occurs, errno is set equal to 
EIDRM, and a value of -1 is returned. 

The calling process receives a signal that is to be caught. In this case a mes¬ 
sage is not received and the calling process resumes execution in the manner 
prescribed in signal(2)). 

Msgrcv will fail and no message will be received if one or more of the following are true: 
[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process. 

[EINVAL] Msgsz is less than 0. 

[E2BIG] Mtext is greater than msgsz and (msgflg & MSG_NOERROR) is “false”. 
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[ENOMSG] The queue does not contain a message of the desired type and (msgtyp & 

IPC_NOWAIT) is “true”. 

[EFAULT] Msgp points to an illegal address. 

Upon successful completion, the following actions are taken with respect to the data struct ure 
associated with msqid (see intro (2)). 

Msg_qnum is decremented by 1. 

Msg_lrpid is set equal to the process ED of the calling process. 

Msg_rtime is set equal to the current time. 

RETURN VALUES 

If msgsnd or msgrcv return due to the receipt of a signal, a value of -I is returned to the cal¬ 
ling process and errno is set to EINTR. If they return due to removal of msqid from the sys¬ 
tem, a value of -1 is returned and errno is set to EIDRM. 

Upon successful completion, the return value is as follows: 

Msgsnd returns a value of 0. 

Msgrcv returns a value equal to the number of bytes actually placed into mtext. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

intro(2), msgctl(2), msgget(2), signal(2). 
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NAME 

open - open a file for reading or writing, or create a new file 

SYNOPSIS 

^include <sys/file.h> 

open(path, flags, mode) 
char *path; 
int flags, mode; 


DESCRIPTION 

Open opens the file path for reading and/or writing, as specified by the flags argument and 
returns a descriptor for that file. The flags argument may indicate the file is to be created if 
it does not already exist (by specifying the 0_CREAT flag), in which case the file is created 
with mode mode as described in chmod( 2) and modified by the process’ umask value (see 
umask(2)). 

Path is the address of a string of ASCII characters representing a path name, terminated by a 
null character. The flags specified are formed by or’ing the following values 


0_RD0NLY open for reading only 
0_WR0NLY open for writing only 
0_RDWR open for reading and writing 
0_NDELAY do not block on open 
0_APPEND append on each write 
0_CREAT create file if it does not exist 
0_TRUNC truncate size to 0 
0_EXCL error if create and file exists 


Opening a file with 0_APPEND set causes each write on the file to be appended to the end. 
If Q_TRUNC is specified and the file exists, the file is truncated to zero length. If 0_EXCL is 
set with 0_CREAT, then if the file already exists, the open returns an error. This can be 
used to implement a simple exclusive access locking mechanism. If the 0_NDELAY flag is 
specified and the open call would result in the process being blocked for some reason (e.g. 
waiting for carrier on a dialup line), the open returns immediately. The first time the process 
attempts to perform i/o on the open file it will block (not currently implemented). 

Upon successful completion a non-negative integer termed a file descriptor is returned. The 
file pointer used to mark the current position within the file is set to the beginning of the file. 

The new descriptor is set to remain open across execve system calls; see close{ 2). 

No process may have more than {OPEN_MAX} file descriptors open simultaneously. 


ERRORS 

The named file is opened unless one or more of the following are true: 


[EPERM] 

[ENOTDIR] 

[ENOENT] 

[EACCES] 

[EACCES] 

[EISDIR] 


The pathname contains a character with the high-order bit set. 

A component of the path prefix is not a directory. 

0_CREAT is not set and the named file does not exist. 

A component of the path prefix denies search permission. 

The required permissions (for reading and/or writing) are denied for the 
named flag. 

The named file is a directory, and the arguments specify it is to be opened 
for writing. 
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[EROFS] The named file resides on a read-only file system, and the file is to be 

modified. 

[EMFILE] {OPEN_MAX} file descriptors are currently open. 

[ENX30] The named file is a character special or block special file, and the device asso¬ 

ciated with this special file does not exist. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being executed and the 
open call requests write access. 

[EFAULT] Path points outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EEXIST] 0_EXCL was specified and the file exists. 

[ENXIO] The 0_NDELAY flag is given, and the file is a communications device on 

which their is no carrier present. 

[EOPNOTSUPP] 

An attempt was made to open a socket (not currently implemented). 

SEE ALSO 

chmod(2), close(2), dup(2), lseek(2), read(2), write(2), umask(2) 
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NAME 

pipe - create an interprocess communication channel 

SYNOPSIS 

pipe(fildes) 
int Sides[2]; 

DESCRIPTION 

The pipe system call creates an I/O mechanism called a pipe. The file descriptors returned 
can be used in read and write operations. When the pipe is written using the descriptor 
fildes[l] up to 4096 bytes of data are buffered before the writing process is suspended. A read 
using the descriptor fildes[ 0] will pick up the data. 

It is assumed that after the pipe has been set up, two (or more) cooperating processes (created 
by subsequent fork calls) will pass data through the pipe with read and write calls. 

The shell has a syntax to set up a linear array of processes connected by pipes. 

Read calls on an empty pipe (no buffered data) with only one end (all write file descriptors 
closed) returns an end-of-file. 

Pipes are really a special case of the socketpair( 2) call and, in fact, are implemented as such in 
the system. 

A signal is generated if a write on a pipe with only one end is attempted. 

RETURN VALUE 

The function value zero is returned if the pipe was created; -1 if an error occurred. 

ERRORS 

The pipe call will fail if: 

[EMFILE] Too many descriptors are active. 

[EFAULT] The fildes buffer is in an invalid area of the process’s address space. 

SEE ALSO 

sh(l), read(2), write(2), fork(2), socketpair(2) 

BUGS 

Should more than 4096 bytes be necessary in any pipe among a loop of processes, deadlock 
will occur. 
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NAME 

profil - execution time profile 

SYNOPSIS 

profiI(buff, bufsiz, offset, scale) 
char *buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the 
user’s program counter (pc) is examined each clock tick (20 milliseconds); offset is subtracted 
from it, and the result multiplied by scale. If the resulting number corresponds to a word 
inside buff, that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 
0x10000 gives a 1-1 mapping of pc’s to words in buff; 0x8000 maps each pair of instruction 
words together. 0x2 maps all instructions onto the beginning of buff (producing a non¬ 
interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a bufsiz of 
0. Profiling is turned off when an execve is executed, but remains on in child and parent both 
after a fork. Profiling is turned off if an update in buff would cause a memory fault. 

RETURN VALUE 

A 0, indicating success, is always returned. 

SEE ALSO 

gprof(l), setitimer(2), monitor(3) 
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NAME 

ptrace - process trace 

SYNOPSIS 

^include <signal.h> 

ptrace(request, pid, addr, data) 
int request, pid, *addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution of a child pro¬ 
cess, and examine and change its core image. Its primary use is for the implementation of 
breakpoint debugging. There are four arguments whose interpretation depends on a request 
argument. Generally, pid is the process ID of the traced process, which must be a child (no 
more distant descendant) of the tracing process. A process being traced behaves normally 
until it encounters some signal whether internally generated like “illegal instruction” or exter¬ 
nally generated like “interrupt”. See sigvec(2) for the list. Then the traced process enters a 
stopped state and its parent is notified via u>ait(2). When the child is in the stopped state, its 
core image can be examined and modified using ptrace. If desired, another ptrace request can 
then cause the child either to terminate or to continue, possibly ignoring the signal. 

The value of the request argument determines the precise action of the call: 

0 This request is the only one used by the child process; it declares that the process is to be 
traced by its parent. All the other arguments are ignored. Peculiar results will ensue if 
the parent does not expect to trace the child. 

1,2 The word in the child process’s address space at addr is returned. If I and D space are 
separated (e.g. historically on a pdp-ll), request 1 indicates I space, 2 D space. Addr 
must be even. The child must be stopped. The input data is ignored. 

3 The word of the system’s per-process data area corresponding to addr is returned. Addr 
must be even and less than 512. This space contains the registers and other information 
about the process; its layout corresponds to the user structure in the system. 

4,5 The given data is written at the word in the process’s address space corresponding to 
addr, which must be even. No useful value is returned. If I and D space are separated, 
request 4 indicates I space, 5 D space. Attempts to write in pure procedure fail if another 
process is executing the same file. 

6 The process’s system data is written, as it is read with request 3. Only a few locations 
can be written in this way: the general registers, the floating point status and registers, 
and certain bits of the processor status word. 

7 The data argument is taken as a signal number and the child’s execution continues at 
location addr as if it had incurred that signal. Normally the signal number will be either 
0 to indicate that the signal that caused the stop should be ignored, or that value fetched 
out of the process’s image indicating which signal caused the stop. If addr is (int *)1 then 
execution continues from where it stopped. 

8 The traced process terminates. 

9 Execution continues as in request 7; however, as soon as possible after execution of at 
least one instruction, execution stops again. The signal number from the stop is 
SIGTRAP. (On ICON systems the trace-bit is set and just one instruction is executed.) 
This is part of the mechanism for implementing breakpoints. 
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As indicated, these calls (except for request 0) can be used only when the subject process has 
stopped. The wait call is used to determine when a process stops; in such a case the “termi¬ 
nation” status returned by wait has the value 0177 to indicate stoppage rather than genuine 
termination. 

To forestall possible fraud, ptrace inhibits the set-user-id and set-group-id facilities on subse¬ 
quent execve(2) calls. If a traced process calls execve, it will stop before executing the first 
instruction of the new image showing signal SIGTRAP. 

On an ICON system, “word” also means a 32-bit integer, but the “even” restriction does not 
apply. 

RETURN VALUE 

A 0 value is returned if the call succeeds. If the call fails then a -1 is returned and the global 
variable errno is set to indicate the error. 


ERRORS 

[EINVAL] 

[EINVAL] 

[EINVAL] 

[EFAULT] 

[EPERM] 


The request code is invalid. 

The specified process does not exist. 
The given signal number is invalid. 
The specified address is out of bounds. 
The specified process cannot be traced. 


SEE ALSO 

wait(2), sigvec(2), adb(l) 


BUGS 

Ptrace is unique and arcane; it should be replaced with a special file which can be opened and 
read and written. The control functions could then be implemented with ioctl(2 ) calls on this 
file. This would be simpler to understand and have much higher performance. 

The request 0 call should be able to specify signals which are to be treated normally and not 
cause a stop. In this way, for example, programs with simulated floating point (which use 
“illegal instruction” signals at a very high rate) could be efficiently debugged. 

The error indication, -1, is a legitimate function value; errno, see intro{ 2), can be used to 
disambiguate. 

It should be possible to stop a process on occurrence of a system call; in this way a completely 
controlled environment could be provided. 
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NAME 

quota - manipulate disk quotas 

SYNOPSIS 

•^include <sys/quota.h> 

quota(cmd, uid, arg, addr) 
int cmd, uid, arg; 
caddr_t addr; 

DESCRIPTION 

The quota call manipulates disk quotas for file systems which have had quotas enabled with 
setquota( 2). The cmd parameter indicates a command to be applied to the user ID uid. Arg is 
a command specific argument and addr is the address of an optional, command specific, data 
structure which is copied in or out of the system. The interpretation of arg and addr is given 
with each command below. 

Q_SETDLIM 

Set disc quota limits and current usage for the user with ID uid. Arg is a major-minor 
device indicating a particular file system. Addr is a pointer to a struct dqblk structure 
(defined in <sys/quota.h>). This call is restricted to the super-user. 

Q_GETDLIM 

Get disc quota limits and current usage for the user with ID uid. The remaining 
parameters are as for Q_SETDLIM. 

Q.SETDUSE 

Set disc usage limits for the user with ID uid. Arg is a major-minor device indicating 
a particular file system. Addr is a pointer to a struct dqusage structure (defined in 
<sys/quota.h>). This call is restricted to the super-user. 

QJSYNC 

Update the on-disc copy of quota usages. The uid, arg, and addr parameters are 
ignored. 

QJSETUID 

Change the calling process’s quota limits to those of the user with ID uid. The arg 
and addr parameters are ignored. This call is restricted to the super-user. 

QJSETWARN 

Alter the disc usage warning limits for the user with ID uid. Arg is a major-minor 
device indicating a particular file system. Addr is a pointer to a struct dqwarn struc¬ 
ture (defined in <sys/quota.h>). This call is restricted to the super-user. 

Q_DOWARN 

Warn the user with user ID uid about excessive disc usage. This call causes the system 
to check its current disc usage information and print a message on the terminal of the 
caller for each file system on which the user is over quota. If the arg parameter is 
specified as NODEV, all file systems which have disc quotas will be checked. Other¬ 
wise, arg indicates a specific major-minor device to be checked. This call is restricted 
to the super-user. 

RETURN VALUE 

A successful call returns 0 and, possibly, more information specific to the cmd performed; 
when an error occurs, the value -1 is returned and errno is set to indicate the reason. 
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ERRORS 

A quota call will fail when one of the following occurs: 

[EINVAL] Cmd is invalid. 

[ESRCH] No disc quota is found for the indicated user. 

[EPERM] The call is priviledged and the caller was not the super-user. 

[EINVAL] The arg parameter is being interpreted as a major-minor device and it indi¬ 

cates an unmounted file system. 

[EFAULT] An invalid addr is supplied; the associated structure could not be copied in or 
out of the kernel. 

[EUSERS] The quota table is full. 


SEE ALSO 

setquota(2), quotaon(8), quotacheck(8) 


BUGS 

There should be someway to integrate this call with the resource limit interface provided by 
setrlimit{ 2) and getrlimit(2). 

The Australian spelling of disk is used throughout the quota facilities in honor of the imple¬ 
mentors. 


2 


ICON INTERNATIONAL 



READ(2) 


SYSTEM CALLS 


READ (2) 


NAME 

read, readv - read input 

SYNOPSIS 

cc = read(d, buf, nbytes) 
int cc, d; 
char *buf; 
int nbytes; 

#include <sys/types.h> 

#include <sys/uio.h> 

cc = readv(d, iov, iovcnt) 
int cc, d; 
struct iovec *iov; 
int iovcnt; 

DESCRIPTION 

Read attempts to read nbytes of data from the object referenced by the descriptor d into the 
buffer pointed to by buf. Readv performs the same action, but scatters the input data into 
the iovcnt buffers specified by the members of the iovec array: iov[0], iov[l], iov[iovcnt-1]. 

For readv, the iovec structure is defined as 

struct iovec { 

caddr_t iov_base; 

int iov Jen; 

}; 

Each iovec entry specifies the base address and length of an area in memory where data 
should be placed. Readv will always fill an area completely before proceeding to the next. 

On objects capable of seeking, the read starts at a position given by the pointer associated 
with d, see lseek{ 2). Upon return from read, the pointer is incremented by the number of 
bytes actually read. 

Objects that are not capable of seeking always read from the current position. The value of 
the pointer associated with such a object is undefined. 

Upon successful completion, read and readv return the number of bytes actually read and 
placed in the buffer. The system guarantees to read the number of bytes requested if the 
descriptor references a file which has that many bytes left before the end-of-file, but in no 
other cases. 

If the returned value is 0, then end-of-file has been reached. 

RETURN VALUE 

If successful, the number of bytes actually read is returned. Otherwise, a -1 is returned and 
the global variable errno is set to indicate the error. 

ERRORS 

Read and readv will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid file descriptor open for reading. 

[EFAULT] Buf points outside the allocated address space. 
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[EINTR] A read from a slow device was interrupted before any data arrived by the 

delivery of a signal. 

In addition, readv may return one of the following errors: 

[EINVAL] Iovcnt was less than or equal to 0, or greater than 16. 

[EINVAL] One of the iovjlen values in the iov array was negative. 

[EINVAL] The sum of the iovjlen values in the iov array overflowed a 32-bit integer. 

SEE ALSO 

dup(2), open(2), pipe(2), socket(2), socketpair(2) 
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NAME 

readlink - read value of a symbolic link 

SYNOPSIS 

cc = readlink(path, buf, bufsiz) 
int cc; 

char *path, *buf; 
int bufsiz; 

DESCRIPTION 

Readlink places the contents of the symbolic link name in the buffer buf which has size bufsiz. 
The contents of the link are not null terminated when returned. 

RETURN VALUE 

The call returns the count of characters placed in the buffer if it succeeds, or a -1 if an error 
occurs, placing the error code in the global variable errno. 

ERRORS 

Readlink will 

[EPERM] 

[ENOENT] 

[ENOTDIR] 

[ENOENT] 

[ENXIO] 

[EACCES] 

[EPERM] 

[EINVAL] 

[EFAULTJ 
[ELOOP] 

SEE ALSO 

stat(2), lstat(2), symlink(2) 


fail and the file mode will be unchanged if: 

The path argument contained a byte with the high-order bit set. 

The pathname was too long. 

A component of the path prefix is not a directory. 

The named file does not exist. 

The named file is not a symbolic link. 

Search permission is denied on a component of the path prefix. 

The effective user ID does not match the owner of the file and the effective 
user ID is not the super-user. 

The named file is not a symbolic link. 

Buf extends outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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NAME 

reboot - reboot system or halt processor 

SYNOPSIS 

^include <sys/reboot.h> 

reboot(howto) 
int howto; 

DESCRIPTION 

Reboot reboots the system, and is invoked automatically in the event of unrecoverable system 
failures. Howto is a mask of options passed to the bootstrap program. The system call inter¬ 
face permits only RBJHLALT or RB_AUTOBOOT to be passed to the reboot program. When 
none of these options (e.g. RB_AUTOBOOT) is given, the system is rebooted from file 
“vmunix” in the root file system of unit 0 of a disk chosen in a processor specific way. 

The bits of howto are: 

RB_HALT 

the processor is simply halted; no reboot takes place. RB_HALT should be used with 
caution. This switch is not available from the system call interface. 

RB_AUTOBOOT 

All media are synced, and the machine reboots. At reboot time you are offered the 
option to continue with a normal reboot, or to interact with the system loader(8). 

Only the super-user may reboot a machine. 

RETURN VALUES 

If successful, this call never returns. Otherwise, a -1 is returned and an error is returned in 
the global variable errno. 

ERRORS 

[EPERM] The caller is not the super-user. 

SEE ALSO 

crash(8), halt(8), init(8), reboot(8) 
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NAME 

recv, recvfrom, recvmsg - receive a message from a socket 

SYNOPSIS 

^include <sys/types.h> 
include <sys/socket.h> 

cc ass recv(s, buf, len, flags) 
int cc, s; 
char *buf; 
int len, flags; 

cc = recvfrom(s, buf, len, flags, from, fromlen) 

int cc, s; 

char *buf; 

int len, flags; 

struct sockaddr *from; 

int *fromlen; 

cc = recvmsg(s, msg, flags) 
int cc, s; 

struct msghdr msg[]; 
int flags; 

DESCRIPTION 

Recv, recvfrom, and recvmsg are used to receive messages from a socket. 

The recv call may be used only on a connected socket (see connect( 2)), while recvfrom and 
recvmsg may be used to receive data on a socket whether it is in a connected state or not. 

If from is non-zero, the source address of the message is filled in. Fromlen is a value-result 
parameter, initialized to the size of the buffer associated with from, and modified on return to 
indicate the actual size of the address stored there. The length of the message is returned in 
cc. If a message is too long to fit in the supplied buffer, excess bytes may be discarded 
depending on the type of socket the message is received from; see socketf 2). 

If no messages are available at the socket, the receive call waits for a message to arrive, unless 
the socket is nonblocking (see ioctl{ 2)) in which case a cc of -1 is returned with the external 
variable errno set to EWOULDBLOCK. 

The selecl( 2) call may be used to determine when more data arrives. 

The flags argument to a send call is formed by or’ing one or more of the values, 

^define MSG_PEEI< Oxl /* peek at incoming message */ 

^define MSG_OOB 0x2 /* process out-of-band data */ 

The recvmsg call uses a msghdr structure to minimize the number of directly supplied parame¬ 
ters. This structure has the following form, as defined in <sys/socket.h>: 

struct msghdr { 

caddr_t msg_name; /* optional address */ 

int msg_namelen; /* size of address */ 

struct iov *msg_iov; /* scatter/gather array */ 

int msg_iovlen; /* # elements in msg_iov */ 

caddr_t msg_accrights; /* access rights sent/received */ 

int msg_accrightslen; 

}; 
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Here msg^name and msg_namelen specify the destination address if the socket is unconnected; 
m$g_name may be given as a null pointer if no names are desired or required. The msg_iov 
and msg_iovlen describe the scatter gather locations, as described in read(2). Access rights to 
be sent along with the message are specified in msg^accrights, which has length 
msg_accrightslen. 

RETURN VALUE 

These calls return the number of bytes received, or -1 if an error occurred. 

ERRORS 

The calls fail if: 

[EBADF] The argument s is an invalid descriptor. 

[ENOTSOCK] The argument s is not a socket. 

[EWOULDBLOCK] The socket is marked non-blocking and the receive operation would 

block. 

[EINTR] The receive was interrupted by delivery of a signal before any data was 

available for the receive. 

[EFAULT] The data was specified to be received into a non-existent or protected 

part of the process address space. 

SEE ALSO 

read(2), send(2), socket(2) 
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NAME 

rename - change the name of a file 

SYNOPSIS 

rename(from, to) 
char *from, *to; 

DESCRIPTION 

Rename causes the link named from to be renamed as to. If to exists, then it is first removed. 
Both from and to must be of the same type (that is, both directories or both non-directories), 
and must reside on the same file system. 

Rename guarantees that an instance of to will always exist, even if the system should crash in 
the middle of the operation. 

CAVEAT 

The system can deadlock if a loop in the file system graph is present. This loop takes the 
form of an entry in directory “a”, say “a/foo”, being a hard link to directory “b”, and an 
entry in directory “b”, say “b/bar”, being a hard link to directory “a”. When such a loop 
exists and two separate processes attempt to perform “rename a/foo b/bar” and “rename 
b/bar a/foo”, respectively, the system may deadlock attempting to lock both directories for 
modification. Hard links to directories should be replaced by symbolic links by the system 
administrator. 


RETURN VALUE 

A 0 value is returned if the operation succeeds, otherwise rename returns -1 and the global 
variable errno indicates the reason for the failure. 


ERRORS 

Rename will fail and neither of the argument files will be affected if any of the following are 
true: 


[ENOTDIR] 

[ENOENTj 

[EACCES] 

[ENOENTj 

[EPERM] 

[EXDEV] 

[EACCES] 

[EROFS] 

[EFAULT] 

[EINVAL] 


A component of either path prefix is not a directory. 

A component of either path prefix does not exist. 

A component of either path prefix denies search permission. 

The file named by from does not exist. 

The file named by from is a directory and the effective user ID is not super- 
user. 

The link named by to and the file named by from are on different logical 
devices (file systems). Note that this error code will not be returned if the 
implementation permits cross-device links. 

The requested link requires writing in a directory with a mode that denies 
write permission. 

The requested link requires writing in a directory on a read-only file system. 
Path points outside the process’s allocated address space. 

From is a parent directory of to. 


SEE ALSO 

open(2) 
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NAME 

rmdir - remove a directory file 

SYNOPSIS 

rmdir(path) 
char *path; 

DESCRIPTION 

Rmdir removes a directory file whose name is given by path. The directory must not have any 
entries other than and 

RETURN VALUE 

A 0 is returned if the remove succeeds; otherwise a -1 is returned and an error code is stored 
in the global location errno. 

ERRORS 

The named file is removed unless one or more of the following are true: 

[ENOTEMPTY] The named directory contains files other than and in it. 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOENT] The pathname was too long. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EACCES] Write permission is denied on the directory containing the link to be 
removed. 

[EBUSY] The directory to be removed is the mount point for a mounted file system. 

[EROFS] The directory entry to be removed resides on a read-only file system. 

[EFAULT] Path points outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

SEE ALSO 

mkdir(2), unlink(2) 
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NAME 

select - synchronous i/o multiplexing 

SYNOPSIS 

^include <sys/time.h> 

nfound = select(nfds, readfds, writefds, execptfds, timeout) 
int nfound, nfds, *readfds, *writefds, *execptfds; 
struct timeval *timeout; 

DESCRIPTION 

Select examines the i/o descriptors specified by the bit masks readfds, writefds, and execptfds 
to see if they are ready for reading, writing, or have an exceptional condition pending, respec¬ 
tively. File descriptor / is represented by the bit “l<<f” in the mask. Nfds desciptors are 
checked, i.e. the bits from 0 through nfds- 1 in the masks are examined. Select returns, in 
place, a mask of those descriptors which are ready. The total number of ready descriptors is 
returned in nfound. 

If timeout is a non-zero pointer, it specifies a maximum interval to wait for the selection to 
complete. If timeout is a zero pointer, the select blocks indefinitely. To affect a poll, the 
timeout argument should be non-zero, pointing to a zero valued timeval structure. 

Any of readfds, writefds, and execptfds may be given as 0 if no descriptors are of interest. 

RETURN VALUE 

Select returns the number of descriptors which are contained in the bit masks, or -1 if an 
error occurred. If the time limit expires then select returns 0. 

ERRORS 

An error return from select indicates: 

[EBADF] One of the bit masks specified an invalid descriptor. 

[EINTRj An signal was delivered before any of the selected for events occurred or the 

time limit expired. 

SEE ALSO 

accept(2), connect(2), read(2), write(2), recv(2), send(2) 


BUGS 

The descriptor masks are always modified on return, even if the call returns as the result of 
the timeout. 
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NAME 

semctl - semaphore control operations 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/ipc.h> 

#include <sys/sem.h> 

int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 

struct semid_ds *buf; 
ushort *array; 

} arg; 

DESCRIPTION 

Semctl provides a variety of semaphore control operations as specified by cmd. 

The following cmds are executed with respect to the semaphore specified by semid and sem¬ 
num: 

GETVAL Return the value of semval (see intro(2)). {READ} 

SETVAL Set the value of semval to arg.val. {ALTER} When this cmd is success¬ 

fully executed, the semadj value corresponding to the specified sema¬ 
phore in all processes is cleared. 

GETPID Return the value of sempid. {READ} 

GETNCNT Return the value of semncnt. {READ} 

GETZCNT Return the value of semzcnt. {READ} 

The following cmds return and set, respectively, every semval in the set of semaphores. 

GETALL Place semvals into array pointed to by arg. array. {READ} 

SETALL Set semvals according to the array pointed to by arg.array. {ALTER} 
When this cmd is successfully executed the semadj values corresponding 
to each specified semaphore in all processes are cleared. 

The following cmds are also available: 

IPCJ5TAT Place the current value of each member of the data structure associated 
with semid into the structure pointed to by arg.buf. The contents of 
this structure are defined in intro( 2). {READ} 

IPCJ3ET Set the value of the following members of the data structure associated 
with semid to the corresponding value found in the structure pointed to 
by arg.buf: 
sem_perm.uid 
sem_perm.gid 

sem_perm.mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an effective user ID 
equal to either that of super-user or to the value of sem_perm.uid in 
the data structure associated with semid. 
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IPCJRMDD 


Semctl will 

[EINVAL] 

[EINVAL] 

[EINVAL] 

[EACCES] 

[ERANGE] 

[EPERM] 


[EFAULT] 


Remove the semaphore identifier specified by semid from the system 
and destroy the set of semaphores and data structure associated with it. 
This cmd can only be executed by a process that has an effective user ID 
equal to either that of super-user or to the value of sem_perm.uid in 
the data structure associated with semid. 

fail if one or more of the following are true: 

Semid is not a valid semaphore identifier. 

Semnum is less than zero or greater than sem_nsems. 

Cmd is not a valid command. 

Operation permission is denied to the calling process (see intro( 2)). 

Cmd is SETVAL or SETALL and the value to which semval is to be 
set is greater than the system imposed maximum. 

Cmd is equal to IPCLRMID or IPC.SET and the effective user ID of the 
calling process is not equal to that of super-user and it is not equal to 
the value of sem_perm.uid in the data structure associated with 
semid. 

Arg.buf points to an illegal address. 


RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 
GETVAL The value of semval. 

GETPID The value of sempid. 

GETNCNT The value of semncnt. 

GETZCNT The value of semzcnt. 

All others A value of 0. 

Otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

intro(2), semget(2), semop(2). 


2 


ICON INTERNATIONAL 





SEMGET (2) 


SYSTEM CALLS 


SEMGET (2) 


NAME 

semget - get set of semaphores 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

^include <sys/sem.h> 

int semget (key, nsems, semflg) 

key_t key; 

int nsems, semflg; 

DESCRIPTION 

Semget returns the semaphore identifier associated with key. 

A semaphore identifier and associated data structure and set containing nsems semaphores 
(see intro( 2)) are created for key if one of the following are true: 

Key is equal to IPCLPRIVATE 

Key does not already have a semaphore identifier associated with it, and ( semflg & 
IPC_CREAT) is “true”. 

Upon creation, the data structure associated with the new semaphore identifier is initialized as 
follows: 

Sem_perm.cuid, sem_perm.uid, sem_perm.cgid, and sem_perm.gid are set equal 
to the effective user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of sem_perm.mode are set equal to the low-order 9 bits of 
semflg. 

Sem_nsems is set equal to the value of nsems. 

Sem_otime is set equal to 0 and sem_ctime is set equal to the current time. 

Semget will fail if one or more of the following are true: 

[EINVAL] Nsems is either less than or equal to zero or greater than the system-imposed 

limit. 

[EACCES] A semaphore identifier exists for key, but operation permission (see intro(2)) 

as specified by the low-order 9 bits of semflg would not be granted. 

[EINVAL] A semaphore identifier exists for key, but the number of semaphores in the 

set associated with it is less than nsems and nsems is not equal to zero. 

[ENOENT] A semaphore identifier does not exist for key and ( semflg & IPCLCREAT) is 

“false”. 

[ENOSPC] A semaphore identifier is to be created but the system-imposed limit on the 

maximum number of allowed semaphore identifiers system wide would be 
exceeded. 

[ENOSPC] A semaphore identifier is to be created but the system-imposed limit on the 

maximum number of allowed semaphores system wide would be exceeded. 

[EEXIST] A semaphore identifier exists for key but ( ( semflg & IPCLCREAT) and ( semflg 

& IPCJEXCL)) is “true”. 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a semaphore identifier, is 
returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 

intro(2), semctl(2), semop(2). 
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NAME 

semop - semaphore operations 

SYNOPSIS 

•^include <sys/types.h> 

#include <sys/ipc.h> 

#inelude <sys/8em.h> 

int semop (semid, sops, nsops) 
int semid; 

struct sembuf ♦wops; 
int nsops; 

DESCRIPTION 

Semop is used to automatically perform an array of semaphore operations on the set of sema¬ 
phores associated with the semaphore identifier specified by semid. Sops is a pointer to the 
array of semaphore-operation structures. Nsops is the number of such structures in the array. 
The contents of each structure includes the following members: 

short sem_num; /* semaphore number */ 

short sem_op; /* semaphore operation */ 

short sem_flg; /* operation flags */ 

Each semaphore operation specified by sem_op is performed on the corresponding semaphore 
specified by semid and sem^num. 

Sem_op specifies one of three semaphore operations as follows: 

If sem_op is a negative integer, one of the following will occur: {ALTER} 

If semval (see intro(2)) is greater than or equal to the absolute value of 
sem_op, the absolute value of sem_op is subtracted from semval. Also, if 
(sem_fig & SEM_UNDO) is “true”, the absolute value of sem_op is added to 
the calling process’s semadj value (see exit( 2)) for the specified semaphore. 

If semval is less than the absolute value of sem_op and (sem^flg & 

IPC_NOWAIT) is “true”, semop will return immediately. 

If semval is less than the absolute value of sem_op and (sem_flg & 

IPC_NOWAIT) is “false”, semop will increment the semnent associated with 
the specified semaphore and suspend execution of the calling process until one 
of the following conditions occur. 

Semval becomes greater than or equal to the absolute value of sem_op. 
When this occurs, the value of semnent associated with the specified sema¬ 
phore is decremented, the absolute value of sem_op is subtracted from sem¬ 
val and, if (sem^flg & SEM_UNDO) is “true”, the absolute value of sem_op 
is added to the calling process’s semadj value for the specified semaphore. 

The semid for which the calling process is awaiting action is removed from 
the system (see semctl( 2)). When this occurs, errno is set equal to EIDRM, 
and a value of -1 is returned. 

The calling process receives a signal that is to be caught. When this occurs, 
the value of semnent associated with the specified semaphore is decre¬ 
mented, and the calling process resumes execution in the manner prescribed 
in signal( 2). 
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If sem_op is a positive integer, the value of sem_op is added to semval and. if 
(sem^flg & SEMLUNDO) is “true”, the value of sem_op is subtracted from the calling 
process’s semadj value for the specified semaphore. {ALTER} 

If sem_op is zero, one of the following will occur: {READ} 

If semval is zero, semop will return immediately. 

If semval is not equal to zero and (sem^flg & EPCLNOWAJT) is “true”, semop 
will return immediately. 

If semval is not equal to zero and ( sem_flg & IPC_NOWAIT) is “false”, semop 
will increment the semzcnt associated with the specified semaphore and 
suspend execution of the calling process until one of the following occurs: 

Semval becomes zero, at which time the value of semzcnt associated with 
the specified semaphore is decremented. 

The semid for which the calling process is awaiting action is removed from 
the system. When this occurs, errno is set equal to EIDRM, and a value of 
-1 is returned. 


The calling process receives a signal that is to be caught. When this occurs, 
the value of semzcnt associated with the specified semaphore is decre¬ 
mented, and the calling process resumes execution in the manner prescribed 
in signal( 2). 

Semop will fail if one or more of the following are true for any of the semaphore operations 
specified by sops: 


[EINVAL] 

[EFBIG] 

[E2BIG] 

[EACCES] 

[EAGAIN] 

[ENOSPC] 


Semid is not a valid semaphore identifier. 

Sem_num is less than zero or greater than or equal to the number of sema¬ 
phores in the set associated with semid. 

Nsops is greater than the system-imposed maximum. 

Operation permission is denied to the calling process (see intro(2)). 

The operation would result in suspension of the calling process but ( sem_Jig 
& IPC_NOWAIT) is “true”. 

The limit on the number of individual processes requesting an SEM_UNDO 
would be exceeded. 


[EINVAL] The number of individual semaphores for which the calling process requests a 

SEM_UNDO would exceed the limit. 


[ERANGE] An operation would cause a semval to overflow the system-imposed limit. 

[ERANGE] An operation would cause a semadj value to overflow the system-imposed 

limit. 

[EFAULT] Sops points to an illegal address. 

Upon successful completion, the value of sempid for each semaphore specified in the array 
pointed to by sops is set equal to the process ID of the calling process. 


RETURN VALUE 

If semop returns due to the receipt of a signal, a value of -1 is returned to the calling process 
and errno is set to EINTR. If it returns due to the removal of a semid from the system, a 
value of -1 is returned and errno is set to EIDRM. 
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Upon successful completion, the value of semval at the time of the call for the last operation 
in the array pointed to by sops is returned. Otherwise, a value of -1 is returned and errno is 
set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 
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NAME 

send, sendto, sendmsg - send a message from a socket 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/socket.h> 

cc = send(s, msg, len, flags) 
int cc, s; 
char *msg; 
int len, flags; 

cc = sendto(s, msg, len, flags, to, tolen) 

int cc, s; 

char *m8g; 

int len, flags; 

struct sockaddr *to; 

int tolen; 

cc — sendmsg(s, msg, flags) 
int cc, s; 

struct msghdr msgQ; 
int flags; 

DESCRIPTION 

Send, sendto, and sendmsg are used to transmit a message to another socket. Send may be 
used only when the socket is in a connected state, while sendto and sendmsg may be used at 
any time. 

The address of the target is given by to with tolen specifying its size. The length of the mes¬ 
sage is given by len. If the message is too long to pass atomically through the underlying pro¬ 
tocol, then the error EMSGSIZE is returned, and the message is not transmitted. 

No indication of failure to deliver is implicit in a send. Return values of -1 indicate some 
locally detected errors. 

If no messages space is available at the socket to hold the message to be transmitted, then 
send normally blocks, unless the socket has been placed in non-blocking i/o mode. The 
select( 2) call may be used to determine when it is possible to send more data. 

The flags parameter may be set to SOF_OOB to send “out-of-band” data on sockets which 
support this notion (e.g. SOCK_STREAM). 

See recv(2) for a description of the msghdr structure. 

RETURN VALUE 

The call returns the number of characters sent, or -1 if an error occurred. 


ERRORS 

[EBADF] 

[ENOTSOCK] 

[EFAULT] 


An invalid descriptor was specified. 

The argument s is not a socket. 

An invalid user space address was specified for a parameter. 
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[EMSGSIZE] 

[EWOULDBLOCK] 


The socket requires that message be sent atomically, and the size of the 
message to be sent made this impossible. 

The socket is marked non-blocking and the requested operation would 
block. 


SEE ALSO 

recv(2), socket(2) 
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NAME 

setgroups - set group access list 

SYNOPSIS 

^include <sys/param.h> 

setgroups(ngroups, gidset) 
int ngroups, *gidset; 

DESCRIPTION 

Setgroups sets the group access list of the current user process according to the array gidset. 
The parameter ngroups indicates the number of entries in the array and must be no more 
than NGRPS, as defined in <sy$/param.h>. 

Only the super-user may set new groups. 

RETURN VALUE 

A 0 value is returned on success, -1 on error, with a error code stored in errno. 


ERRORS 


The setgroups call will fail if: 

[EPERM] The caller is not the super-user. 

[EFAULT] The address specified for gidset is outside the process address space. 

SEE ALSO 

getgroups(2), initgroups(3X) 
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NAME 

setpgrp - set process group 

SYNOPSIS 

setpgrp(pid, pgrp) 
int pid, pgrp; 

DESCRIPTION 

Setpgrp sets the process group of the specified process pid to the specified pgrp. 
then the call applies to the current process. 

If the invoker is not the super-user, then the affected process must have the 
user-id as the invoker or be a descendant of the invoking process. 

RETURN VALUE 

Setpgrp returns when the operation was successful. If the request failed, -1 is returned and 
the global variable errno indicates the reason. 

ERRORS 

Setpgrp will 

[ESRCH] 

[EPERM] 

SEE ALSO 

getpgrp(2) 


fail and the process group will not be altered if one of the following occur: 

The requested process does not exist. 

The effective user ID of the requested process is different from that of the 
caller and the process is not a descendent of the calling process. 


If pid is zero, 
same effective 
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NAME 

setquota - enable/disable quotas on a file system 

SYNOPSIS 

setquota(special, file) 
char special, *file; 

DESCRIPTION 

Disc quotas are enabled or disabled with the setquota call. Special indicates a block special 
device on which a mounted file system exists. If file is nonzero, it specifies a file in that file 
system from which to take the quotas. If file is 0, then quotas are disabled on the file system. 
The quota file must exist; it is normally created with the checkquota( 8) program. 

Only the super-user may turn quotas on or off. 

SEE ALSO 

quota(2), quotacheck(8), quotaon(8) 

RETURN VALUE 

A 0 return value indicates a successful call. A value of -1 is returned when an error occurs 
and errno is set to indicate the reason for failure. 

ERRORS 

Setquota will fail when one of the following occurs: 

[NODEV] The caller is not the super-user. 

[NODEV] Special does not exist. 

[ENOTBLK] Special is not a block device. 

[ENXIO] The major device number of special is out of range (this indicates no device 

driver exists for the associated hardware). 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOTDIR] A component of the path prefix in file is not a directory. 

[EROFS] File resides on a read-only file system. 

[EACCES] File resides on a file system different from special. 

[EACCES] File is not a plain file. 

BUGS 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 
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NAME 

setregid - set real and effective group ID 

SYNOPSIS 

setregid(rgid, egid) 
int rgid, egid; 

DESCRIPTION 

The real and effective group ID’s of the current process are set to the arguments. Only the 
super-user may change the real group ID of a process. Unpriviledged users may change the 
effective group ID to the real group ID, but to no other. 

Supplying a value of -1 for either the real or effective group ID forces the system to substitute 
the current ID in place of the -1 parameter. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than changing 

the effective group-id to the real group-id was specified. 

SEE ALSO 

getgid(2), setreuid(2), setgid(3) 
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NAME 

setreuid - set real and effective user ID’s 

SYNOPSIS 

setreuid(ruid, euid) 
int ruid, euid; 

DESCRIPTION 

The real and effective user ID’s of the current process are set according to the arguments. If 
ruid or euid is -1, the current uid is filled in by the system. Only the super-user may modify 
the real uid of a process. Users other than the super-user may change the effective uid of a 
process only to the real uid. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than changing 

the effective user-id to the real user-id was specified. 

SEE ALSO 

getuid(2), setregid(2), setuid(3) 
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NAME 

shmctl - shared memory control operations 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/ipc.h> 

#in elude <sys/shm.h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid_ds *buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control operations as specified by cmd. The fol¬ 
lowing cmds are available: 

IPC_STAT Place the current value of each member of the data structure associated 
with shmid into the structure pointed to by buf. The contents of this 
structure are defined in [EINVAL] intro(2). {READ} 

IPCLSET Set the value of the following members of the data structure associated 
with shmid to the corresponding value found in the structure pointed to 
by buf : 

shm_perm.uid 

shm_perm.gid 

shm_perm.mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an effective user ID 
equal to either that of super user or to the value of shm_perm.uid in 
the data structure associated with shmid. 

IPCLRMID Remove the shared memory identifier specified by shryu'd from the system 
and destroy the shared memory segment and data structure associated 
with it. This cmd can only be executed by a process that has an effective 
user ID equal to either that of super user or to the value of 
shm_perm.uid in the data structure associated with shmid. 

SHMLLOCK Lock the shared memory segment specified by shmid in memory. This 
cmd can only be executed by a process that has an effective usr ID equal 
to super user. 

SHM_ UNLOCK 

Unlock the shared memory segment specified by shmid. This cmd can 
only be executed by a process that has an effective usr ID equal to super 
user. 

Shmctl will fail if one or more of the following are true: 

Shmid is not a valid shared memory identifier. [EINVAL] 

Cmd is not a valid command. [EINVAL] 

Cmd is equal to IPC_STAT and {READ} operation permission is denied to the calling 
process (see intro( 2)). [EACCES] 

Cmd is equal toIPC_RMID or IPCJ3ET and the effective user ID of the calling process is 
not equal to that of super user and it is not equal to the value of shm_perm.uid in 
the data structure associated with shmid. [EPERM] 
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NAME 

setquota - enable/disable quotas on a file system 

SYNOPSIS 

setquota(special, file) 
char ^special, 

DESCRIPTION 

Disc quotas are enabled or disabled with the setquota call. Special indicates a block special 
device on which a mounted file system exists. If file is nonzero, it specifies a file in that, file 
system from which to take the quotas. If file is 0, then quotas are disabled on the file system. 
The quota file must exist; it is normally created with the checkquota(8) program. 

Only the super-user may turn quotas on or off. 

SEE ALSO 

quota(2), quotacheck(8), quotaon(8) 

RETURN VALUE 

A 0 return value indicates a successful call. A value of -1 is returned when an error occurs 
and errno is set to indicate the reason for failure. 


ERRORS 

Setquota will fail when one of the following occurs: 

[NODEV] The caller is not the super-user. 

[NODEV] Special does not exist. 

[ENOTBLK] Special is not a block device. 

[ENXIO] The major device number of special is out of range (this indicates no device 

driver exists for the associated hardware). 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOTDIR] A component of the path prefix in file is not a directory. 

[EROFS] File resides on a read-only file system. 

[EACCES] File resides on a file system different from special. 

[EACCES] File is not a plain file. 


BUGS 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 
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NAME 

setregid - set real and effective group ID 

SYNOPSIS 

setregid (rgid, egid) 
int rgid, egid; 

DESCRIPTION 

The real and effective group ID’s of the current process are set to the arguments. Only the 
super-user may change the real group ID of a process. Unpriviledged users may change the 
effective group ID to the real group ID, but to no other. 

Supplying a value of -1 for either the real or effective group ID forces the system to substitute 
the current ID in place of the -1 parameter. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than changing 

the effective group-id to the real group-id was specified. 

SEE ALSO 

getgid(2), setreuid(2), setgid(3) 
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NAME 

setreuid - set real and effective user ID’s 

SYNOPSIS 

setreuid(ruid, euid) 
int ruid, euid; 

DESCRIPTION 

The real and effective user ID’s of the current process are set according to the arguments. If 
ruid or euid is -1, the current uid is filled in by the system. Only the super-user may modify 
the real uid of a process. Users other than the super-user may change the effective uid of a 
process only to the real uid. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than changing 

the effective user-id to the real user-id was specified. 

SEE ALSO 

getuid(2), setregid(2), setuid(3) 
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NAME 

shmctl - shared memory control operations 
SYNOPSIS 

^Include <sys/types.h> 
include <sys/ipc.h> 

^include <sys/shm.h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid_ds *buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control operations as specified by cmd. The fol¬ 
lowing cmds are available: 

IPCjSTAT Place the current value of each member of the data structure associated 
with shmid into the structure pointed to by buf. The contents of this 
structure are defined in [EINVAL] intro( 2). {READ} 

IPCLSET Set the value of the following members of the data structure associated 
with shmid to the corresponding value found in the structure pointed to 
by buf : 

shm_perm.uid 
shm_perm.gid 

shm_perm.mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an effective user ID 
equal to either that of super user or to the value of shm_perm.uid in 
the data structure associated with shmid. 

Remove the shared memory identifier specified by shmid from the system 
and destroy the shared memory segment and data structure associated 
with it. This cmd can only be executed by a process that has an effective 
user ID equal to either that of super user or to the value of 
shm_perm.uid in the data structure associated with shmid. 

Lock the shared memory segment specified by shmid in memory. This 
cmd can only be executed by a process that has an effective usr ID equal 
to super user. 

SHM_ UNLOCK 

Unlock the shared memory segment specified by shmid. This cmd can 
only be executed by a process that has an effective usr ID equal to super 
user. 

Shmctl will fail if one or more of the following are true: 

Shmid is not a valid shared memory identifier. (EINVAL] 

Cmd is not a valid command. (EINVAL] 

Cmd is equal to IPC_STAT and {READ} operation permission is denied to the calling 
process (see *ntro(2)). [EACCES] 

Cmd is equal to IPC_RMID or IPC_SET and the effective user ID of the calling process is 
not equal to that of super user and it is not equal to the value of shm_perm.uid in 
the data structure associated with shmid. [EPERM] 


IPCJRMED 


SHM_LOCK 
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Cmd is equal to SHM_LOCK or SHM.UNLOCK and the effective user ID of the calling 
process is not equal to that of super user. (EPERM] 

Cmd is equal to SHM.UNLOCK and the shared-memory segment specified by shmid is 
not locked in memory. [EINVAL] Buf points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -I is returned and 
errno is set to indicate the error. 

SEE ALSO 

shmget(2), shmop(2). 
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NAME 

shmget - get shared memory segment 

SYNOPSIS 

^include <sys/types.h> 
^include <sys/ipc.h> 

^include <sys/shm.h> 

int shmget (key, size, shmflg) 

key_t key; 

int size, shmflg; 


DESCRIPTION 

Shmget returns the shared memory identifier associated with key. 

A shared memory identifier and associated data structure and shared memory segment of size 
size bytes (see intro( 2)) are created for key if one of the following are true: 

Key is equal to IPCLPRIVATE 

Key does not already have a shared memory identifier associated with it, and (shmflg 
& IPCLCREAT) is “true”. 

Upon creation, the data structure associated with the new' shared memory identifier is initial¬ 
ized as follows: 


Shm_perm.cuid, shm_perm.uid, shm_perm.cgid, and shm_perm.gid are set 

equal to the effective user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of shm_perm.mode are set equal to the low-order 9 bits of 
shmflg. Shm_segsz is set equal to the value of size. 

Shm_lpid, shm_nattch, shm_atime, and shm_dtime are set equal to 0. 


Shm_ctime is set equal to the current time. 

Shmget will fail if one or more of the following are true: 

[EINVAL] Size is less than the system-imposed minimum or greater than the system- 

imposed maximum. 

[EACCES] A shared memory identifier exists for key but operation permission (see 

intro( 2)) as specified by the low-order 9 bits of shmflg w’ould not be granted. 

[EINVAL] A shared memory identifier exists for key but the size of the segment associ¬ 

ated with it is less than size and size is not equal to zero. 

[ENOENT] A shared memory identifier does not exist for key and ( shmflg & IPCLCREAT) 

is “false”. 


[ENOSPC] 

[ENOMEM] 

[EEXIST] 


A shared memory identifier is to be created but the system-imposed limit on 
the maximum number of allowed shared memory identifiers system wide 
would be exceeded. 

A shared memory identifier and associated shared memory segment are to be 
created but the amount of available physical memory is not sufficient to fill 
the request. 

A shared memory identifier exists for key but ( ( shmflg & IPC_CREAT) and ( 
shmflg & IPCJEXCL) ) is “true”. 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a shared memory identifier is 
returned. Otherwise, a value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 

intro(2), shmctl(2), shmop(2). 
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NAME 

shmop - shared memory operations 
SYNOPSIS 

^include <sys/types.h> 
include <sys/ipc.h> 

^include <sys/shm.h> 

char *shmat (shmid, shmaddr, shmflg) 
int shmid; 
char shmaddr 
int shmflg; 

int shmdt (shmaddr) 
char ^shmaddr 

DESCRIPTION 

Shmat attaches the shared memory segment associated with the shared memory identifier 
specified by shmid to the data segment of the calling process. The segment is attached at the 
address specified by one of the following criteria: 

If shmaddr is equal to zero, the segment is attached at the first available address as 
selected by the system. 

If shmaddr is not equal to zero and ( shmflg & SHM_RND) is “true”, the segment is 
attached at the address given by ( shmaddr - (shmaddr modulus SHMLBA)). 

If shmaddr is not equal to zero and ( shmflg & SHM_RND) is “false”, the segment is 
attached at the address given by shmaddr. 

The segment is attached for reading if {shmflg & SHM_RDONLY) is “true” {READ}, otherwise 
it is attached for reading and writing {READ/WRITE}. 

Shmat will fail and not attach the shared memory segment if one or more of the following are 


true: 


[EINVALJ 

Shmid is not a valid shared memory identifier. 

[EACCES] 

Operation permission is denied to the calling process (see intro{ 2)). 

[ENOMEM] 

The available data space is not large enough to accommodate the shared 
memory segment. 

[EINVAL] 

Shmaddr is not equal to zero, and the value of ( shmaddr - (shmaddr modulus 
SHMLBA)) is an illegal address. 

[EINVAL] 

Shmaddr is not equal to zero, ( shmflg & SHM_RND) is “false”, and the value 
of shmaddr is an illegal address. 

[EMFILE] 

The number of shared memory segments attached to the calling process 
would exceed the system-imposed limit. 

[EINVAL] 

Shmdt detaches from the calling process’s data segment the shared memory 
segment located at the address specified by shmaddr. 

[EINVAL] 

Shmdt will fail and not detach the shared memory segment if shmaddr is not 
the data segment start address of a shared memory segment. 

RETURN VALUES 



Upon successful completion, the return value is as follows: 
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Shmat returns the data segment start address of the attached shared memory segment. 
Shmdt returns a value of 0. 

Otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 


2 


ICON INTERNATIONAL 



SHUTDOWN (2) 


SYSTEM CALLS 


SHUTDOWN (2) 


NAME 

shutdown - shut down part of a full-duplex connection 

SYNOPSIS 

shutdown(s, how) 
int s, how; 

DESCRIPTION 

The shutdown call causes all or part of a full-duplex connection on the socket associated with s 
to be shut down. If how is 0, then further receives will be disallowed. If how is 1, then 
further sends will be disallowed. If how is 2, then further sends and receives will be disal¬ 
lowed. 


DIAGNOSTICS 

A 0 is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] S is not a valid descriptor. 

[ENOTSOCK] S' is a file, not a socket. 
[ENOTCONN] The specified socket is not connected. 

SEE ALSO 

connect(2), socket(2) 
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NAME 

sigblock - block signals 

SYNOPSIS 

sigblock(mask); 
int mask; 

DESCRIPTION 

Sigblock causes the signals specified in mask to be added to the set of signals currently being 
blocked from delivery. Signal * is blocked if the »-th bit in mask is a 1. 

It is not possible to block SIGKILL, SIGSTOP, or SIGCONT; this restriction is silently 
imposed by the system. 

RETURN VALUE 

The previous set of masked signals is returned. 

SEE ALSO 

kill(2), sigvec(2), sigsetmask(2), 
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NAME 

sigpause - atomically release blocked signals and wait for interrupt 

SYNOPSIS 

sigpause(sigmask) 
int sigmask; 

DESCRIPTION 

Sigpause assigns sigmask to the set of masked signals and then waits for a signal to arrive; on 
return the set of masked signals is restored. Sigmask is usually 0 to indicate that no signals 
are now to be blocked. Sigpause always terminates by being interrupted, returning EINTR. 

In normal usage, a signal is blocked using sigblock( 2), to begin a critical section, variables 
modified on the occurance of the signal are examined to determine that there is no work to be 
done, and the process pauses awaiting work by using sigpause with the mask returned by sig- 
block. 

SEE ALSO 

sigblock(2), sigvec(2) 
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NAME 

sigsetmask - set current signal mask 

SYNOPSIS 

sigsetmask(mask); 
int mask; 

DESCRIPTION 

Sigsetmask sets the current signal mask (those signals which are blocked from delivery). Sig¬ 
nal i is blocked if the t'-th bit in mask is a 1. 

The system quietly disallows SIGKILL, SIGSTOP, or SIGCONT to be blocked. 

RETURN VALUE 

The previous set of masked signals is returned. 

SEE ALSO 

kill(2), sigvec(2), sigblock(2), sigpause(2) 
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NAME 

sigstack - set and/or get signal stack context 

SYNOPSIS 

include <signal.h> 

struct sigstack { 

caddr_t ss_sp; 
int ss_onstack; 

}; 

sigstack(ss, oss); 
struct sigstack *ss, *oss; 

DESCRIPTION 

Sigstack allows users to define an alternate stack on which signals are to be processed. If ss is 
non-zero, it specifies a signal stack on which to deliver signals and tells the system if the pro¬ 
cess is currently executing on that stack. When a signal’s action indicates its handler should 
execute on the signal stack (specified with a sigvec(2) call), the system checks to see if the pro¬ 
cess is currently executing on that stack. If the process is not currently executing on the sig¬ 
nal stack, the system arranges a switch to the signal stack for the duration of the signal 
handler’s execution. If oss is non-zero, the current signal stack state is returned. 

NOTES 

Signal stacks are not “grown” automatically, as is done for the normal stack. If the stack 
overflows unpredictable results may occur. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Sigstack will fail and the signal stack context will remain unchanged if one of the following 
occurs. 

[EFAULT] Either ss or oss points to memory which is not a valid part of the process 

address space. 

SEE ALSO 

sigvec(2), setjmp(3) 
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NAME 

sigvec - software signal facilities 

SYNOPSIS 

^include <signal.h> 

struct sigvec { 

int (*sv_handler)(); 

int sv_mask; 

int sv_onstack; 

}; 

sigvec (sig, vec, ovec) 
int sig; 

struct sigvec *vec, *ovec; 

DESCRIPTION 

The system defines a set of signals that may be delivered to a process. Signal delivery resem¬ 
bles the occurence of a hardware interrupt: the signal is blocked from further occurrence, the 
current process context is saved, and a new one is built. A process may specify a handler to 
which a signal is delivered, or specify that a signal is to be blocked or ignored . A process may 
also specify that a default action is to be taken by the system when a signal occurs. Nor¬ 
mally, signal handlers execute on the current stack of the process. This may be changed, on a 
per-handler basis, so that signals are taken on a special signal stack. 

All signals have the same priority. Signal routines execute with the signal that caused their 
invocation blocked , but other signals may yet occur. A global signal mask defines the set of 
signals currently blocked from delivery to a process. The signal mask for a process is initilized 
from that of its parent (normally 0). It may be changed with a sigblock(2) or sigsetmask( 2) 
call, or when a signal is delivered to the process. 

When a signal condition arises for a process, the signal is added to a set of signals pending for 
the process. If the signal is not currently blocked by the process then it is delivered to the 
process. When a signal is delivered, the current state of the process is saved, a new signal 
mask is calculated (as described below), and the signal handler is invoked. The call to the 
handler is arranged so that if the signal handling routine returns normally the process will 
resume execution in the context from before the signal’s delivery. If the process wishes to 
resume in a different context, then it must arrange to restore the previous context itself. 

When a signal is delivered to a process a new signal mask is installed for the duration of the 
process’ signal handler (or until a sigblock or sigsetmask call is made). This mask is formed by 
taking the current signal mask, adding the signal to be delivered, and or’ing in the signal 
mask associated with the handler to be invoked. 

Sigvec assigns a handler for a specific signal. If vec is non-zero, it specifies a handler routine 
and mask to be used when delivering the specified signal. Further, if sv^onstack is 1, the sys¬ 
tem will deliver the signal to the process on a signal stack , specified with sigstack( 2). If ovec is 
non-zero, the previous handling information for the signal is returned to the user. 

The following is a list of all signals with names as in the include file <signal.h >: 


SIGHUP 

1 

hangup 

SIGINT 

2 

interrupt 

SIGQUIT 

3* 

quit 

SIGILL 

4* 

illegal instruction 

SIGTRAP 

5* 

trace trap 


ICON INTERNATIONAL 


1 



SIGVEC (2) 


SYSTEM CALLS 


SIGVEC (2) 


SIGIOT 

6* 

SIGEMT 

7* 

SIGFPE 

8* 

SIGKILL 

9 

SIGBUS 

10* 

SIGSEGV 

11* 

SIGSYS 

12* 

SIGPIPE 

13 

SIGALRM 

14 

SIGTERM 

15 

SIGURG 

16» 

SIGSTOP 

17f 

SIGTSTP 

18t 

SIGCONT 

19* 

SIGCHLD 

20* 

SIGTTIN 

21t 

SIGTTOU 

22f 

SIGIO 

23* 

SIGXCPU 

24 

SIGXFSZ 

25 

SIGVTALRM 26 

SIGPROF 

27 


IOT instruction 

EMT instruction 

floating point exception 

kill (cannot be caught, blocked, or ignored) 

bus error 

segmentation violation 
bad argument to system call 
write on a pipe with no one to read it 
alarm clock 

software termination signal 
urgent condition present on socket 
stop (cannot be caught, blocked, or ignored) 
stop signal generated from keyboard 
continue after stop (cannot be blocked) 
child status has changed 

background read attempted from control terminal 

background write attempted to control terminal 

i/o is possible on a descriptor (see fcntl{ 2)) 

cpu time limit exceeded (see setrlimit{2)) 

file size limit exceeded (see $etrlimit{ 2)) 

virtual time alarm (see setitimer[2)) 

profiling timer alarm (see setitimer{ 2)) 


The starred signals in the list above cause a core image if not caught or ignored. 


Once a signal handler is installed, it remains installed until another sigvec call is made, or an 
execve(2) is performed. The default action for a signal may be reinstated by setting 
sv_handler to SIG_DFL; this default is termination (with a core image for starred signals) 
except for signals marked with • or f. Signals marked with • are discarded if the action is 
SIG_DFL; signals marked with f cause the process to stop. If sv_handler is SIG_IGN the sig¬ 
nal is subsequently ignored, and pending instances of the signal are discarded. 

If a caught signal occurs during certain system calls, causing the call to terminate prema¬ 
turely, the call is automatically restarted. In particular this can occur during a read or 
wrtte(2) on a slow device (such as a terminal; but not a file) and during a wait( 2). 

After a fork(2) or vfork( 2) the child inherits all signals, the signal mask, and the signal stack. 

Execve(2 ) resets all caught signals to default action; ignored signals remain ignored; the signal 
mask remains the same; the signal stack state is reset. 


NOTES 

The mask specified in vec is not allowed to block SIGKILL, SIGSTOP, or SIGCONT. This is 
done silently by the system. 

RETURN VALUE 

A 0 value indicated that the call succeeded. A -1 return value indicates an error occured and 
errno is set to indicated the reason. 

ERRORS 

Sigvec will fail and no new signal handler will be installed if one of the following occurs: 

[EFAULT] Either vec or ovec points to memory which is not a valid part of the process 
address space. 

[EINVAL] Stg is not a valid signal number. 
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[EINVAL] An attempt is made to ignore or supply a handler for SIGKILL or SIGSTOP. 

[EINVAL] An attempt is made to ignore SIGCONT (by default SIGCONT is ignored). 

SEE ALSO 

kill(l), ptrace(2), kill(2), sigblock(2), sigsetmask(2), sigpause(2) sigstack(2), sigvec(2), 
setjmp(3), tty(4) 

BUGS 

This manual page is confusing. 
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NAME 

socket - create an endpoint for communication 
SYNOPSIS 

^include <sys/types.h> 

^include <sys/socket.h> 

s = socket(af, type, protocol) 
int s, af, type, protocol; 


DESCRIPTION 

Socket creates an endpoint for communication and returns a descriptor. 


The af parameter specifies an address format with which addresses specified in later operations 
using the socket should be interpreted. These formats are defined in the include file 
<sy$/socket.h> . The currently understood formats are 


AFJJNIX 

AFJNET 

AF_PUP 

AFJMPLINK 


(UNIX path names), 

(ARPA Internet addresses), 
(Xerox PUP-I Internet addresses) 
(IMP “host at IMP” addresses). 


The socket has the indicated type which specifies the semantics of communication. Currently 
defined types are: 


SOCK_STREAM 

SOCICDGRAM 

SOCK_RAW 

SOCI<_SEQPACKET 

SOCI<_RDM 

A SOCK_STREAM type provides sequenced, reliable, two-way connection based byte streams 
with an out-of-band data transmission mechanism. A SOCK_DGRAM socket supports 
datagrams (connectionless, unreliable messages of a fixed (typically small) maximum length). 
SOCI<_RAW sockets provide access to internal network interfaces. The types SOCK_RAW, 
which is available only to the super-user, and SOCK_SEQPACKET and SOCK_RDM, which 
are planned, but not yet implemented, are not described here. 


The protocol specifies a particular protocol to be used with the socket. Normally only a single 
protocol exists to support a particular socket type using a given address format. However, it 
is possible that many protocols may exist in which case a particular protocol must be specified 
in this manner. The protocol number to use is particular to the “communication domain” in 
which communication is to take place; see semces(3N) and protoco/s(3N). 

Sockets of type SOCK_STREAM are full-duplex byte streams, similar to pipes. A stream 
socket must be in a connected state before any data may be sent or received on it. A connec¬ 
tion to another socket is created with a connect{ 2) call. Once connected, data may be 
transferred using read( 2) and write(2) calls or some variant of the send( 2) and recv(2) calls. 
When a session has been completed a close{ 2) may be performed. Out-of-band data may also 
be transmitted as described in send( 2) and received as described in recv( 2). 

The communications protocols used to implement a SOCK_STREAM insure that data is not 
lost or duplicated. If a piece of data for which the peer protocol has buffer space cannot be 
successfully transmitted within a reasonable length of time, then the connection is considered 
broken and calls will indicate an error with -1 returns and with ETIMEDOUT as the specific 
code in the global variable errno. The protocols optionally keep sockets “warm” by forcing 
transmissions roughly every minute in the absence of other activity. An error is then 
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indicated if no response can be elicited on an otherwise idle connection for a extended period 
(e.g. 5 minutes). A SIGPIPE signal is raised if a process sends on a broken stream; this causes 
naive processes, which do not handle the signal, to exit. 

SOCKJDGRAM and SOCK_RAW sockets allow sending of datagrams to correspondents 
named in send( 2) calls. It is also possible to receive datagrams at such a socket with recv(2). 

An fcntl( 2) call can be used to specify a process group to receive a SIGURG signal when the 
out-of-band data arrives. 

The operation of sockets is controlled by socket level options. These options are defined in 
the file <sys/socket.h> and explained below. Setsockopt and getsockopt(2) are used to set and 
get options, respectively. 


SO_DEBUG 

SCLREUSEADDR 

SO_KEEPALIVE 

SOJDONTROUTE 

SCLLINGER 

SCLDONTLINGER 


turn on recording of 
debugging information 
allow local address reuse 
keep connections alive 
do no apply routing on 
outgoing messages 
linger on close if data present 
do not linger on close 


SO_DEBUG enables debugging in the underlying protocol modules. SO_REUSEADDR indi¬ 
cates the rules used in validating addresses supplied in a bind( 2) call should allow reuse of 
local addresses. SO_KEEPALIVE enables the periodic transmission of messages on a con¬ 
nected socket. Should the connected party fail to respond to these messages, the connection is 
considered broken and processes using the socket are notified via a SIGPIPE signal. 
SO_DONTROUTE indicates that outgoing messages should bypass the standard routing facil¬ 
ities. Instead, messages are directed to the appropriate network interface according to the 
network portion of the destination address. SCLLINGER and SCLDONTLINGER control the 
actions taken when unsent messags are queued on socket and a close( 2) is performed. If the 
socket promises reliable delivery of data and SO_LINGER is set, the system will block the 
process on the close attempt until it is able to transmit the data or until it decides it is unable 
to deliver the information (a timeout period, termed the linger interval, is specified in the set¬ 
sockopt call when SO_LINGER is requested). If SO_DONTLINGER is specified and a close is 
issued, the system will process the close in a manner which allows the process to continue as 
quickly as possible. 


RETURN VALUE 

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the 
socket. 


ERRORS 

The socket call fails if: 

[EAFNOSUPPORT] The specified address family is not supported in this version of the sys¬ 
tem. 

[ESOCKTNOSUPPORT] 

The specified socket type is not supported in this address family. 

[EPROTONOSUPPORT] 

The specified protocol is not supported. 

[EMFILE] The per-process descriptor table is full. 

[ENOBUFS] No buffer space is available. The socket cannot be created. 
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SOCKET (2) 


SYSTEM CALLS 


SOCKET(2) 


SEE ALSO 

accept(2), bind(2), connect(2), getsockname(2), getsockopt(2), ioctl(2), listen(2), recv(2), 
select(2), send(2), shutdown(2), socketpair(2) 

“A 4.2BSD Interprocess Communication Primer”. 

BUGS 

The use of keepalives is a questionable feature for this layer. 
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SOCKETPAIR (2) 


SYSTEM CALLS 


SOCKETPAIR (2) 


NAME 

socketpair - create a pair of connected sockets 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/socket.h> 

socketpair(d, type, protocol, sv) 
int d, type, protocol; 
int sv[2]; 

DESCRIPTION 

The socketpair call creates an unnamed pair of connected sockets in the specified domain d, of 
the specified type, and using the optionally specified protocol. The descriptors used in 
referencing the new sockets are returned in sv[0] and su[l]. The two sockets are indistinguish¬ 
able. 

DIAGNOSTICS 

A 0 is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EMFILE] Too many descriptors are in use by this process. 

[EAFNOSUPPORT] The specified address family is not supported on this machine. 
[EPROTONOSUPPORT] 

The specified protocol is not supported on this machine. 

[EOPNOSUPPORT] The specified protocol does not support creation of socket pairs. 

[EFATJLT] The address sv does not specify a valid part of the process address 

space. 

SEE ALSO 

read(2), write(2), pipe(2) 


BUGS 

This call is currently implemented only for the UNIX domain. 
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STAT (2) 


SYSTEM CALLS 


STAT (2) 


NAME 

stat, lstat, fstat - get file status 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/stat.h> 

stat(path, buf) 
char *path; 
struct stat *buf; 

lstat (path, buf) 
char *path; 
struct stat *buf; 

fstat (fd, buf) 
int fd; 

struct stat *buf; 

DESCRIPTION 

Stat obtains information about the file path. Read, write or execute permission of the named 
file is not required, but all directories listed in the path name leading to the file must be 
reachable. 

Lstat is like stat except in the case where the named file is a symbolic link, in which case lstat 
returns information about the link, while stat returns information about the file the link refer¬ 
ences. 

Fstat obtains the same information about an open file referenced by the argument descriptor, 
such as would be obtained by an open call. 

Buf is a pointer to a stat structure into which information is placed concerning the file. The 
contents of the structure pointed to by buf 

struct stat { 

dev_t st_dev;/* device inode resides on */ 

ino_t st_ino;/* this inode’s number */ 

u_short st_mode;/* protection */ 

short st_nlink;/* number or hard links to the file */ 

short st_uid;/* user-id of owner */ 

short st_gid;/* group-id of owner */ 

dev_t st_rdev;/* the device type, for inode that is device */ 
off_t st_size;/* total size of file */ 

time_t st_atime;/* file last access time */ 
intst_sparel; 

time_t st_mtime;/* file last modify time */ 

intst_spare2; 

time_t st_ctime;/* file last status change time */ 
intst_spare3; 

long st_blksize;/* optimal blocksize for file system i/o ops */ 

long st_blocks;/* actual number of blocks allocated */ 

long st_spare4[2]; 


V. 
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STAT (2) 


SYSTEM CALLS 


STAT (2) 


C st_atime Time when file data was last read or modified. Changed by the following sys¬ 
tem calls: mknod(2), utime$(2), read( 2), and write(2). For reasons of efficiency, 
st_atime is not set when a directory is searched, although this would be more 
logical. 

st_mtime Time when data was last modified. It is not set by changes of owner, group, 
link count, or mode. Changed by the following system calls: mknod( 2), 
utimes{ 2), write( 2). 

st_ctime Time when file status was last changed. It is set both both by writing and 
changing the i-node. Changed by the following system calls: chmod( 2) chown( 2), 
link( 2), mknod(2), unlink{2), utimes(2), write(2). 

The status information word st^mode has bits: 

^define S_IFMT 0170000 /* type of file */ 

#define S_IFDIR 0040000 /* directory */ 

^define S_IFCHR 0020000 /* character special */ 

^define S_IFBLK 0060000 /* block special */ 

#define S_IFREG 0100000 /* regular */ 

^define S_IFLNK 0120000 /* symbolic link */ 

^define S_IFSOCK 0140000 /* socket*/ 

^define S_ISUID 0004000 /* set user id on execution */ 

^define S_ISGID 0002000 /* set group id on execution */ 

^define S_ISVTX 0001000 /* save swapped text even after use */ 

^define S_IREAD 0000400 /* read permission, owner */ 

^define SJfWRITE 0000200 /* write permission, owner */ 

#define S_IEXEC 0000100 /* execute/search permission, owner */ 

* The mode bits 0000070 and 0000007 encode group and others permissions (see chmod( 2)). 

1 When fd is associated with a pipe, fstat reports an ordinary file with an i-node number, res¬ 

tricted permissions, and a not necessarily meaningful length. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Slat and Istat will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOENT] The pathname was too long. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EFAULT] Buf or name points to an invalid address. 

Fstat will fail if one or both of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EFAULT] Buf points to an invalid address. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

c 
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SYSTEM CALLS 


STAT (2) 


CAVEAT 

The fields in the stat structure currently marked st_sparel, st_spare£, and st_spareS are 
present in preparation for inode time stamps expanding to 64 bits. This, however, can break 
certain programs which depend on the time stamps being contiguous (in calls to utimes( 2)). 


SEE ALSO 

chmod(2), chown(2), utimes(2) 


BUGS 

Applying fstat to a socket returns a zero’d buffer. 

The list of calls which modify the various fields should be carefully checked with reality. 
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SYSTEM CALLS 


SWAPON (2) 


NAME 

swapon - specify a swap directory 

SYNOPSIS 

swapon(directory) 
char *directory; 

DESCRIPTION 

Swapon makes the directory directory available to the system for allocation for paging and 
swapping. 

SEE ALSO 

swapon (8) 
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SYSTEM CALLS 


SYMLINK (2) 


NAME 

symlink - make symbolic link to a file 

SYNOPSIS 

8ymlink(namel, name2) 
char *namel, *name2; 

DESCRIPTION 

A symbolic link nameS is created to namel ( name£ is the name of the file created, namel is 
the string used in creating the symbolic link). Either name may be an arbitrary path name; 
the files need not be on the same file system. 

RETURN VALUE 

Upon successful completion, a zero value is returned. If an error occurs, the error code is 
stored in errno and a -1 value is returned. 

ERRORS 

The symbolic 

[EPERM] 

[ENOENT] 

[ENOTDIR] 

[EEXIST] 

[EACCES] 

[EROFS] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

link(2), ln(l), 


link is made unless on or more of the following are true: 

Either namel or nameS contains a character with the high-order bit set. 
One of the pathnames specified was too long. 

A component of the nameS prefix is not a directory. 

NameS already exists. 

A component of the nameS path prefix denies search permission. 

The file nameS would reside on a read-only file system. 

Namel or nameS points outside the process’s allocated address space. 
Too may symbolic links were encountered in translating the pathname. 

unlink(2) 
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SYSTEM CALLS 


SYNC (2) 


NAME 

sync - update super-block 

SYNOPSIS 

syncQ 


This 

Sync 


SEE ALSO 

fsync(2), sync(8), update(8) 

BUGS 

The writing, although scheduled, is not necessarily complete upon return from sync. 


DESCRIPTION 

Sync causes all information in core memory that should be on disk to be written out. 
includes modified super blocks, modified i-nodes, and delayed block I/O. 

Sync should be used by programs which examine a file system, for example fsck, df, etc. 
is mandatory before a boot. 
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SYSCALL (2) 


SYSTEM CALLS 


SYSCALL(2) 


NAME 

syscall - indirect system call 
SYNOPSIS 

syscall(number, arg,...) 

DESCRIPTION 

Syscall performs the system call whose assembly language interface has the specified number, 
register arguments dO and dl and further arguments arg. 

The dO value of the system call is returned. 

DIAGNOSTICS 

When the C-bit is set, syscall returns -1 and sets the external variable errno (see intro( 2)). 

BUGS 

There is no way to simulate system calls such as pipe( 2), which return values in register dl. 
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SYSTEM CALLS 


TRUNCATE (2) 


NAME 

truncate - truncate a file to a specified length 

SYNOPSIS 

truncate(path, length) 
char *path; 
int length; 

ftruncate(fd, length) 
int fd, length; 

DESCRIPTION 

Truncate causes the file named by path or referenced by fd to be truncated to at most length 
bytes in size. If the file previously was larger than this size, the extra data is lost. With 
jtruncate , the file must be open for writing. 

RETURN VALUES 

A value of 0 is returned if the call succeeds. If the call fails a -1 is returned, and the global 
variable errno specifies the error. 


ERRORS 

Truncate succeeds unless: 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOENTj The pathname was too long. 

[ENOTDIR] A component of the path prefix of path is not a directory. 
[ENOENT] The named file does not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EISDIR] The named file is a directory. 

[EROFS] The named file resides on a read-only file system. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being executed. 

[EFAULT] Name points outside the process’s allocated address space. 

Ftruncate succeeds unless: 

[EBADF] The fd is not a valid descriptor. 

[EINVAL] The fd references a socket, not a file. 


SEE ALSO 

open(2) 


BUGS 

Partial blocks discarded as the result of truncation are not zero filled; this can result in holes 
in files which do not read as zero. 

These calls should be generalized to allow ranges of bytes in a file to be discarded. 
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SYSTEM CALLS 


UMASK (2) 


NAME 

umask - set file creation mode mask 
SYNOPSIS 

oumask = umask(numask) 
int oumask, numask; 

DESCRIPTION 

Umask sets the process’s file mode creation mask to numask and returns the previous value of 
the mask. The low-order 9 bits of numask are used whenever a file is created, clearing 
corresponding bits in the file mode (see chmod( 2)). This clearing allows each user to restrict 
the default access to his files. 

The value is initially 022 (write access for owner only). The mask is inherited by child 
processes. 

RETURN VALUE 

The previous value of the file mode mask is returned by the call. 

SEE ALSO 

chmod(2), mknod(2), open(2) 
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SYSTEM CALLS 


UNLINK (2) 


NAME 

unlink - remove directory entry 

SYNOPSIS 

unlink(path) 
char *path; 

DESCRIPTION 

Unlink removes the entry for the file path from its directory. If this entry was the last link to 
the file, and no process has the file open, then all resources associated with the file are 
reclaimed. If, however, the file was open in any process, the actual resource reclamation is 
delayed until it is closed, even though the directory entry has disappeared. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


ERRORS 

The unlink succeeds unless: 

[EPERM] The path contains a character with the high-order bit set. 

[ENOENT] The path name is too long. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EACCES] Write permission is denied on the directory containing the link to be 
removed. 

[EPERM] The named file is a directory and the effective user ID of the process is not 

the super-user. 

[EBUSY] The entry to be unlinked is the mount point for a mounted file system. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 


SEE ALSO 


close(2), link(2), rmdir(2) 
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SYSTEM CALLS 


UTIMES (2) 


NAME 

utimes - set file times 

SYNOPSIS 

^include <sys/time.h> 

utimes (file, tvp) 
char *file; 

struct timeval *tvp[2]; 

DESCRIPTION 

The utimes call uses the “accessed” and “updated” times in that order from the tvp vector to 
set the corresponding recorded times for file. 

The caller must be the owner of the file or the super-user. The “inode-changed” time of the 
file is set to the current time. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Utime will fail 

[EPERM] 

[ENOENT] 

(ENOENT] 

[ENOTD1R] 

[EACCES] 

[EPERM] 

[EACCES] 

[EROFS] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

stat(2) 


if one or more of the following are true: 

The pathname contained a character with the high-order bit set. 

The pathname was too long. 

The named file does not exist. 

A component of the path prefix is not a directory. 

A component of the path prefix denies search permission. 

The process is not super-user and not the owner of the file. 

The effective user ID is not super-user and not the owrner of the file and 
times is NULL and write access is denied. 

The file system containing the file is mounted read-only. 

Tvp points outside the process’s allocated address space. 

Too many symbolic links were encountered in translating the pathname. 


ICON INTERNATIONAL 


1 



VF0RK(2) 


SYSTEM CALLS 


VFORK( 2) 


NAME 

vfork - spawn new process in a virtual memory efficient way 

SYNOPSIS 

pid = vfork() 
int pid; 

DESCRIPTION 

Vfork can be used to create new processes without fully copying the address space of the old 
process, which is horrendously inefficient in a paged environment. It is useful when the pur¬ 
pose of fork( 2) would have been to create a new system context for an execve. Vfork differs 
from fork in that the child borrows the parent’s memory and thread of control until a call to 
execve( 2) or an exit (either by a call to exit(2) or abnormally.) The parent process is 
suspended while the child is using its resources. 

Vfork returns 0 in the child’s context and (later) the pid of the child in the parent’s context. 

Vfork can normally be used just like fork. It does not work, however, to return while running 
in the childs context from the procedure which called vfork since the eventual return from 
vfork would then return to a no longer existent stack frame. Be careful, also, to call _exit 
rather than exit if you can’t execve , since exit will flush and close standard I/O channels, and 
thereby mess up the parent processes standard I/O data structures. (Even with fork it is 
wrong to call exit since buffered data would then be flushed twice.) 

SEE ALSO 

fork(2), execve(2), sigvec(2), wait(2), 

DIAGNOSTICS 

Same as for fork. 


BUGS 

This system call will be eliminated when proper system sharing mechanisms are implemented. 
Users should not depend on the memory sharing semantics of vfork as it will, in that case, be 
made synonymous to fork. 

To avoid a possible deadlock situation, processes which are children in the middle of a vfork 
are never sent SIGTTOU or SIGTTIN signals; rather, output or ioctls are allowed and input 
attempts result in an end-of-file indication. 
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SYSTEM CALLS 


VHANGUP (2) 


NAME 

vhangup - virtually “hangup” the current control terminal 

SYNOPSIS 

vhangupQ 

DESCRIPTION 

Vhangup is used by the initialization process init(8) (among others) to arrange that users are 
given “clean”’ terminals at login, by revoking access of the previous users’ processes to the 
terminal. To effect this, vhangup searches the system tables for references to the control ter¬ 
minal of the invoking process, revoking access permissions on each instance of the terminal 
which it finds. Further attempts to access the terminal by the affected processes will yield i/o 
errors (EBADF). Finally, a hangup signal (S1GHUP) is sent to the process group of the con¬ 
trol terminal. 

SEE ALSO 

init (8) 

BUGS 

Access to the control terminal via /dev/tty is still possible. 

This call should be replaced by an automatic mechanism which takes place on process exit. 
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WAIT (2) 


NAME 

wait, wait3 - wait for process to terminate 

SYNOPSIS 

^include <sys/wait.h> 

pid = wait(status) 
int pid; 

union wait ^status; 

pid = wait(O) 
int pid; 

^include <sys/time.h> 

^include <sys/resource.h> 

pid = wait3(status, options, rusage) 
int pid; 

union wait ^status; 

int options; 

struct rusage *rusage; 

DESCRIPTION 

Wait causes its caller to delay until a signal is received or one of its child processes terminates. 
If any child has died since the last wait, return is immediate, returning the process id and exit 
status of one of the terminated children. If there are no children, return is immediate with 
the value -1 returned. 

On return from a successful wait call, status is nonzero, and the high byte of status contains 
the low byte of the argument to exit supplied by the child process; the low byte of status con¬ 
tains the termination status of the process. A more precise definition of the status word is 
given in <sys/wait.h>. 

Waits provides an alternate interface for programs which must not block when collecting the 
status of child processes. The status parameter is defined as above. The options parameter is 
used to indicate the call should not block if there are no processes which wish to report status 
(WNOHANG), and/or that only children of the current process which are stopped due to a 
SIGTTIN, SIGTTOU, SIGTSTP, or SIGSTOP signal should have their status reported 
(WUNTRACED). If rusage is non-zero, a summary of the resources used by the terminated 
process and all its children is returned (this information is currently not available for stopped 
processes). 

When the WNOHANG option is specified and no processes wish to report status, waits 
returns a pid of 0. The WNOHANG and WUNTRACED options may be combined by or’ing 
the two values. 

NOTES 

See sigvec(2 ) for a list of termination statuses (signals); 0 status indicates normal termination. 
A special status (0177) is returned for a stopped process which has not terminated and can be 
restarted; see ptrace( 2). If the 0200 bit of the termination status is set, a core image of the 
process was produced by the system. 

If the parent process terminates without waiting on its children, the initialization process (pro¬ 
cess ID = 1) inherits the children. 
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WAIT (2) 


Wait and waits are automatically restarted when a process receives a signal while awaiting 
termination of a child process. 


RETURN VALUE 

If wait returns due to a stopped or terminated child process, the process ID of the child is 
returned to the calling process. Otherwise, a value of -1 is returned and errno is set to indi¬ 
cate the error. 

Waits returns -1 if there are no children not previously waited for; 0 is returned if 
WNOHANG is specified and there are no stopped or exited children. 


ERRORS 


and return immediately if one or more of the following are true: 
The calling process has no existing unwaited-for child processes. 
The status or rusage arguments point to an illegal address. 

SEE ALSO 

exit(2) 


Wait will fail 

[ECHILD] 

[EFAULT] 
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NAME 

write, writev - write on a file 

SYNOPSIS 

write(d, buf, nbytes) 
int d; 
char *buf; 
int nbytes; 

^Include <sys/types.h> 

#include <sys/uio.h> 

writev(d, iov, ioveclen) 
int d; 

struct iovec *iov; 
int ioveclen; 

DESCRIPTION 

Write attempts to write nbytes of data to the object referenced by the descriptor d from the 
buffer pointed to by buf. Writev performs the same action, but gathers the output data from 
the iovlen buffers specified by the members of the iovec array: iov[0], iov[ 1 ], etc. 

On objects capable of seeking, the write starts at a position given by the pointer associated 
with d, see lseek( 2). Upon return from write, the pointer is incremented by the number of 
bytes actually written. 

Objects that are not capable of seeking always write from the current position. The value of 
the pointer associated with such an object is undefined. 

If the real user is not the super-user, then write clears the set-user-id bit on a file. This 
prevents penetration of system security by a user who “captures” a writable set-user-id file 
owned by the super-user. 

RETURN VALUE 

Upon successful completion the number of bytes actually w’riten is returned. Otherwise a -1 
is returned and errno is set to indicate the error. 

ERRORS 

Write will fail and the file pointer will remain unchanged if one or more of the following are 
true: 

[EBADF] 

[EPIPE] 

[EPIPE] 

[EFBIG] 

[EFAULT] 

SEE ALSO 

lseek(2), open(2), pipe(2) 


D is not a valid descriptor open for writing. 

An attempt is made to write to a pipe that is not open for reading by any 
process. 

An attempt is made to write to a socket of type SOCK_STREAM which is 
not connected to a peer socket. 

An attempt was made to write a file that exceeds the process’s file size limit 
or the maximum file size. 

Part of iov or data to be written to the file points outside the process’s allo¬ 
cated address space. 
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COMMENTS 


ICON/ UXB REFERENCE MANUAL Volume 1A P/N 172-022-001 


Your comments and suggestions are appreciated and will help us to provide you with the very best 
in system and application documentation. Send your comments to the address at the bottom of this 
page. Users who respond will be entitled to free updates of this manual for one year. 

1. How would you rate this manual for COMPLETENESS? (Please Circle) 

Excellent Poor 

5.4.3..2 ——..1 -.0 

2. Is there any information that you feel should be included or removed? 


3. How would you rate this manual for ACCURACY? (Please Circle) 

Excellent Poor 

5.4 ..3.- 2 -.1..0 

4. Indicate the page number and nature of any error(s) found in this manual. 


5. How would you rate this manual for USABILITY? (Please Circle) 

Excellent Poor 


6. Describe any format or packaging problems you have experienced with this manual and/or 
binder. 


7. Do you have any general comments or suggestions regarding this publication or future 
publications? 
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